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WELCOME TO 
THE OFFICIAL 
MAGAZINE 


his issue marks the fifth birthday of 
the magazine. Happy birthday us! It’s 
been an incredible journey from its 
humble beginnings as a community fanzine, 

to this issue’s Google-powered giveaway. Over 
the course of the last five years we’ve generated 
more than four thousand pages of Raspberry Pi 
content designed to help, inspire, and entertain 
you on your journey with the world’s favourite 
credit card-sized PC. 

In conjunction with our friends at Google, 
we’ve got quite the birthday present for you. 
Those of you who read the print edition will 
have in your hands a brand-new kit designed 
specifically to help you bring Natural Language 
Interaction to your Raspberry Pi projects. 

Over the course of 20 pages, Lucy Hattersley 
expertly demonstrates the power of Google’s new 
Voice HAT, coupled with the Google Assistant 
API, to create a cardboard contraption capable of 
answering any question you put to it. That’s just 
the beginning, though, and we can’t wait to hear 
about the amazing projects you make! 

Here’s to the next five years of the official 
Raspberry Pi magazine. Enjoy the issue. 


SEE PAGE 34 FOR DETAILS 
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WINNERS ANNOUNCED 


French astronaut Thomas Pesquet announces latest winners of Astro Pi competition 


n October last year, then thanked makers “working on _ the Raspberry Pi Foundation. “The 

with the European amazing computer code with your European Challenge provided school 

Space Agency and CNES, Raspberry Pi [devices].” students from every ESA member 
The Raspberry Pi Foundation “This year’s competition country with the opportunity to 
launched the first ever European expands on our previous work design code to be run in space.” 


Astro Pi challenge. 
Students from across Europe l encourag ‘a you tO continue 

were asked to write code 

for the flight of French ESA 


astronaut Thomas Pesquet to the exploring using diffe re nt 


International Space Station (ISS). 
Thomas “As I have been busy doing Ways tO use Astro Pl 


Pesquet with an . , : : 
Actre Prdavicaon science and engineering 1n Space, 


board the ISS. you have been busy in your with British ESA astronaut Tim “With so many excellent 
eheee classrooms preparing science Peake,” explains Dave Honess, the submissions, it was really hard 
Agency) investigations,” says Thomas. He Astro Pi Programme Manager at to choose the best code to run 


ail 
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ASTRO PI EU WINNERS 


NOW TRENDING 


The stories we shared that 
flew around the world 


magpi.cc/2n5UWX 


The RX300 is a thin client computer built using a 
Raspberry Pi. It enables people to build Windows 

‘ (or Linux) virtual environments and set up offices 
for an affordable price. 


nt 


on the ISS,” says Thomas. The Gr board the ISS. Credit: ESA European Epcesocesscocccesecce sds 

code runs on two space-hardened _—_ Space Agency) —:-: |. = Tag Om 

Raspberry Pi units, or Astro Pis. 5 cummin = RM eee 

Affectionately nicknamed Ed and In the coming weeks, Thomas 52% ioe in ea 

Izzy, the units were launchedinto will be supervising Astro Pi is “Te % 

space on an Atlas V rocket in 2015. ‘Ed’, continuously running code iii 
Dave reveals that the entries provided by students. , ae a © 

included a cheeky bit of coding: “I Astro Pi doesn’t end here, 

found one team who were trying though — watch out for an 

to find the public IP address of announcement this September. P| ZERO W ANTENNA 


the ISS. It made a call out to a web “T encourage you to continue 
server, then they tried toemail the exploring using different ways 
returned page to themselves! No to use Astro Pi to create more Our story about how one smart idea made the 
networking code is allowed to flyso amazing projects,” adds Thomas. new Pi Zero W possible intrigued the Google 
they were disqualified, butI might “Use your imagination, ask Plus community. Clever surface-mount antenna 
email them and say ‘nice try kid!’ ” yourself questions, and have fun.” technology from Proant enabled Pi engineers to 
add wireless networking to the Pi Zero W. 


magpi.cc/2lylWJhX 


THE WINNERS 


Everyone produced great will be uploading your code Sila Resrberey Pi tere W'Vi.T FECiIOS SNUCR AE Lae | 
work, and the judges found digitally using the space-to- Oe ete) tans SO ® 
it tough to narrow the entries ground link over the next few Fe C € e et 
down. In addition to the winning weeks. Your code will be executed, we —— 
submissions, a number of and any files created will be 
teams were awarded ‘Highly downloaded from space and & 
Commended’ status. These returned to winners for analysis. 
teams will also have their code ie full list of winners and FREE PI ZERO W 
run on the ISS. highly commended teams can 

The Raspberry Pi Foundation be found on the Raspberry magpi.cc/2lwRp6N 
would Like to say thank you to Pi Foundation website 


Get a free Pi Zero W with an official case and 


everyone who participated. ESA (magpi.cc/206mZwaA). 


adapter cables! Our new subscription offer was 
the top tweet last month. 
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MonsterBorg is a rugged robot with 
a 3mm thick aluminium chassis 


KICKSTARTER TARGET 


Monster success for PiBorg’s biggest robot yet 


owering forth on its 10cm wheels, the on rough surfaces, so we thought we would design 
MonsterBorg has smashed through its something that essentially was a bigger, more 
Kickstarter target: 1749% funded, with powerful off-road version.” 


pledges totalling £52,471 (magpi.cc/20BdFzg). 


“We are stoked!” exclaims PiBorg’s Tim Freeburn, The MonsterB OIQ 


who says the robot will soon also be on general sale 


from piborg.org. ) 
The Tim tells us the idea for MonsterBorg came about IS based Of PiBorg S 
ThunderBorg following the first FormulaPi race series using the 


controller can drive -vetjBorg. “A lot of people wanted to buy and build ThunderBorg board 


larger motors than 
previous boards the robots themselves, but to also use it outdoors or 


Equipped with four 300 rpm Zhengke 37 mm 
Ce) €3 ay Ss ey at) motors, MonsterBorg is PiBorg’s fastest, most 
- powerful robot yet. “It has enough torque to flip itself 
ThunderBorc om over when going from full forward to full reverse on 
5 Amps flat ground!” reveals Tim. “It can tank-steer on all 
reese Me Oe OND MN sorts of surfaces — grass, carpet, bitumen — and it 
| climbs hills very well.” 
5 Le ce le he ei The MonsterBorg is based on PiBorg’s new 
PPP ETE epet= i, E ThunderBorg motor controller board. Also available 
) Pik ¥ \ | separately, this provides a dual output of up to5 A. 
A running time of up to three hours (using ten AA 
batteries) will permit longer races in the upcoming 
MonsterBorg FormulaPi series, whose use of the 
Raspberry Pi 3 should lend itself to “more complex 
code such as neural networks and self-learning 
algorithms,” says Tim. “I think we will see some 
serious entries and some really great lap times.” 
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Western Digital, WD, the WD logo, WDLabs, Project Spaces, and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. Raspberry Pi is a trademark 
of the Raspberry Pi Foundation. microSD is a trademark of SD-3C, LLC. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies 
depending on operating environment. Product specifications subject to change without notice. Pictures shown may vary from actual product, © 2017 Western Digital Corporation or its affiliates. 
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NEW 
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JAM KIT 


New resources for organisers 
of Raspberry Jam events 


RASPBERRy 


JAN Vy 


aspberry Jams are hugely Communities and Outreach. “It’s GU! DE BO 0 
popular community been really interesting and exciting K 
events where people to gather all this advice and share it 
eather to learn digital making with "in this guidebook.” ? ae GATHERED Fro, 
Raspberry Pi. They’re a great way The Raspberry Jam Guidebook BERRY Pi comm uN : re 
to find out more about the Pi and is a free guide to running a Jam 
meet like-minded folks. that you can download from 
The Raspberry Pi Foundation the Raspberry Jam website. The your Jam. As soon as you have Above The new 
has released two new products to Starter Kit contains a projects submitted your Jam to the calendar eer rag 
support the teams that organise book, printed worksheets, leaflets, | on the Raspberry Pi website, you 
Raspberry Jams. stickers, and a copy of The MagPi. can request your Jam Starter Kit. 
“The community of Jam makers It also features a branding pack For more information on how to 
has so much great advice for people _ of logos, assets, and templates download the Jam Guidebook and 
starting their own Jam,” says Clare for you to easily make your own Starter Pack, visit the Raspberry 
Sutcliffe, Executive Director of posters and flyers to advertise Jam website (magpi.cc/28Nxeff). 


INNERS 


he Raspberry Pi Foundation has announced 
the winners of its first Pioneers challenge. 
“We laid down the epic challenge of making 
us laugh,” says Olympia Brown, Senior Programmes 
Manager. “And boy, did the teams deliver! My face hurt 
from all the laughing on judging day.” 

Theme winners were The Technological Tricksters, 
with their Singing Potato. Heritage Hackers and their 
Water Pistol Trap won the Inspiring Journey award, 
Black Thunder and their Living Joke Robot won the 
Best Explanation award, while Shady Hackers and their 
Scare Chair Rig won the Technically Brilliant award. 

The Pioneers programme challenges teenagers aged 
12-15 to form teams of digital makers and share their 
builds online. The next Pioneers challenge will be 
announced shortly. Head over to the Pioneers website 


Mir uegmee’s Prod ra lane 2rdes (magpi.cc/20oMNarc) and sign up for the newsletter to 
teenagers to form digital maker teams 
bekeprip to dale: 
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SURVEY RESULTS fyy{(270) 


SURVEY MAKER 


RESULIS 


Results of maker survey show keen interest 


in smart technology 


ack in January 2017, we 
asked the Raspberry Pi 
community to respond 
to a Google survey canvassing 
opinions from makers. 
“We conducted a survey to 
understand how makers would 


want to use artificial intelligence 


in their work,” says Kristine 
Kohlhepp, a User Experience 


Researcher working on AIY Projects 


at Google. “These results, along 
with other feedback we gather 
from the community, will help 
us figure out where to take AIY 
Projects next.” 

The team at Google are busy 
analysing this data and plan 
to share more results via their 
website soon. In the meantime, 
you can get a sneak peek (to the 
right) of some of the results. 


The Voice HAT included with 
this month's AIY Projects kit 


SURVEY 


IN NUMBERS 
OVER 15,000 


Ry INTERESTED IN 
O 


MACHINE LEARNING 


MAKERS 


Over half of makers wanted to learn more. 
gbout machine learning. Of those... 


0% HAVE WORKED ON 
O 


O HAVE WORKED 
QO% on 


Oy, IDENTIFY AS 
t% 
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This chess robot moves the pieces by robotic hand 


nspired by the 18th- determines when it’s the Raspberry 
century Mechanical Turk, Turk’s turn, and it then makes a move 
Joey Meyer has built using its robotic arm, equipped with 
a chess-playing robot based ona an electromagnet to lift the pieces. 
Raspberry Pi 3 (raspberryturk.com). After the Turk spends one second 
OpenCV is used to interpret the ‘thinking’ using the Stockfish 


overhead view of the board from a chess engine, Joey tells us: “It takes 
Camera Module. A Python program between 20-40 seconds to make 


its move depending on how far it 

has to reach and whether or not it 

is capturing a piece (needs to make : 
two trips).” ( 


Not only does the Raspberry Turk 
look impressive, but nobody has 
managed to beat it yet. “The Stockfish 


engine is so powerful that even 4 
running on a computer as small as the 
- ») The Raspberry Turk makes a move using its 
Pi, it can play at Grandmaster level. robotic arm, which also removes captured pieces 


oftIntegration Inc has launched Ch 8.0, 
+ —}- “the most complete cross-platform C/C++ 
interpreter”, available free for Raspberry Pi 


users as part of the C-STEMbian OS based on Raspbian 


(magpi.cc/201JVNO). The latter also includes a 
WiringPi binding for Ch to enable easier access to the 
Pi’s GPIO pins in C/C++ programs. 
Cross- platform C/C 44 interpreter | Equipped with a user-friendly IDE (ChIDE), Ch 
_ 1s designed to help students learn coding, robotics, 
for Raspber ry Pl and maths. Wayne Cheng, SoftIntegration’s VP for 


DEB he CE Application and Business Development, points out: 
SQor : breton cog 


=e —_ : : “Ch is a superset of C with salient features of C++ and 
DEGRA SG XOGX ae AlAa x | : many extensions including computational arrays, 


7 $ 


plotting, QuickAnimation, and advanced numerical 
savavensaxsvacsssaenseuseveevenstetort eerie . | : computing capabilities. Ch is also a command shell, a 
een 5) —— ' very high-level language (VHLL) for shell programming 
ad | and scripting for rapid prototyping. Therefore, Ch can 
ns verganpeztancle't) mane” M8 : NN — be used not only for learning C/C++, but also for serious 
‘| software development and applications.” 
, ) } } | As well as 1999 ISO C Standard (C99) and C++ classes, 
ven 4. bbowp(-0.5ee)esin(3*R 4) = Ch supports many industry standards including POSIX, 
X11, and OpenGL. An Embedded version of Ch is also 
i. ie Dj available, enabling users to embed Ch into C/C++ 
applications as a Scripting and programming engine. 


criticaldssped( 
*(ieh*e)* { 
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Roboteers from around the world 
gathered in Cambridge for the Pi 
Wars robotics challenge 


obot makers from around the UK and further 

afield assembled for Pi Wars 2017, the annual 

challenge-based robotics competition 
Starring Raspberry Pi robots. 

This year’s challenge, on 1-2 April, was held at the 
Cambridge Computer Laboratory. Pi Wars is open to 
teams from around the world. 

The competition typically sees around 30 teams from 
schools, families, and hobbyists compete for two full 
days of robotics fun and games. 

Pi Wars 3.0 was moved from December to April, 
giving student teams an extra three months to build 
and test robots (and making it easier for students 
starting term in September to enter). 

The event was held over two days, with the Saturday 
being for Schools/Kids Club; and Sunday for Beginners, 
Intermediates & Pros/Veterans. 

Competitors took part in an Obstacle Course, Line 
Follower, Straight-Line Speed Test, Skittles, Shghtly 
Deranged Golf and The Minimal Maze. There were also 
prizes awarded for Artistic and Technical Merit. 

ExaBot came top on Schools day, while Brian 
Corteil’s ‘2 wheels or not 2 wheels’ won on Sunday. For 
full results, see magpi.cc/20aeUqV. 


ExaBot (Michael Syree) 

Kenilworth School Computer Club (Edward 
Powell, Daniel Sendula) 

Cranmere Code Club (Richard Hayler) 
Adams’ Federation (Kevin Brace) 
QM-Pi-Bot (Jon Witts) 


2 wheels or not 2 wheels (Brian Corteil) 
Ipswich Makerspace / Robot Tractorbot 
(Keith Ellis) 

Metabot3 (John Palombo / Lance Robson) 
KEITH 3 - ‘Mostly Harmless’ (Harry Merckel) 
Hitchin Hackspace (David Booth) 


raspberrypi.org/magpi 


Brian Corteil's ‘2 wheels or not 2 
wheels’ won the Pros/Veterans event 


Michael Syree and the ExaBot team 
won first place in the Schools day 


a DEXTER 


N DUS TR 


20+ new presi as your | Pi robot car. 


BrickPi3 


LEGO MINDSTORMS + RASPBERRY PI 


www.dexterindustries.com 
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his month, Google is Then you will learn how to add 
launching a new initiative voice commands to your own projects. 
called AIY Projects to For example, you can register for 
bring do-it-yourself artificial commands, such as “turn the lights 
intelligence (AI) to the maker on” or “robot, turn right and move 
community. AIY Projects isa forwards”. In the kit, Google has 
series of open-source designs that included an accessory board, called 
demonstrate how easy it is to add Voice HAT, that is loaded with 
AI to your projects. breakout pins to wire up a variety of 
In this issue of The MagPi, we sensors and components, as well as 
are thrilled to present the very the microphone and speaker. 
first project, a free kit that lets Google can’t wait for makers to 
you explore voice recognition and build intelligent devices that solve real 
natural language understanding. world problems and share them back 
You will build a cardboard device | to the community to inspire others. 
that uses the Google Assistant to Your kit is a fantastic way to add 
answer questions, like “how far voice control to your projects, and 
away is the moon?” or “what is 18 start exploring what’s possible 
percent of 92°”. with AI. 
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atural Human Interaction 

is this idea of being able 

to communicate with an 
electronic device the same way 
you and | are talking right now,” 
says Billy Rutledge, Director of 
ATY Projects at Google. We’ve 
caught up at Raspberry Pi Towers 
to discuss the ATY Projects kit, and 
the future of artificial intelligence 
with the maker community. 

“We’re all familiar with 

graphical user interfaces (GUI)”, 
notes Billy. “Well, building a VUI 
is now the big thing.” Voice has 


(| MagPi May 2017) 


become “very popular” in the last 
year, says Billy. “Not just with 
consumer products, but also asa 
set of tools for device makers.” 

Google wants to help makers 
familiarise themselves with voice 
interfaces, but it’s also really keen 
to tap into the creative prowess of 
the maker community. 

“We’re excited to put the kits out 
into the world and see what people 
make with them,” says Kristine 
Kohlhepp, a User Experience 
Researcher working on AIY Projects 
at Google. “We’ve done a lot of 
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research to make sure people can 
assemble the kit and figure out 
how to make it work.” 

“The initial project is just an 
opener,” reveals Blaise Aguera 
y Arcas, Principal Scientist at 
Google. “It’s fun to be able to 
make a cardboard kit that uses the 
Google Assistant, but this is about 
a lot more than just making a 
lower-cost DIY version of Home.”’ 

The future belongs to intelligent 
devices. Billy says: “At some point 
soon, we’ll see a new generation 
of devices that you can just walk 
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up to and ask ‘what are you and 
what do you do’ Then you’1l 
have a conversation with it, to 
use its Services in a very easy-to- 
understand way.” 
Natural Human Interaction 
is the term used for this kind of 
interaction between humans and 
devices. “A generation or two ago, 
all of our devices had analogue 
dials and knobs,” explains 
Billy. “Then there was a shift 
to digital buttons and displays. 
Now we are moving to a human 
interface where you simply have a 
conversation with the device.” 
It’s also important to ease 
people into Al as part of their 
natural interaction with electronic 


devices, alongside touching 
buttons and screens. “We can 
easily become distracted by 
personification of these kinds of 
systems,” says Blaise. 

It’s important for makers to 
realise that VUIs are something 
they can create, and use, in their 
projects. “I think letting the 
makers see how easy it is to put 
Al, specifically Natural Human 
Interaction capabilities, into their 
projects will be a great thing,” 
says Kristine. 

“We want to show you how easy 
it is to use Al, and then share back 


with us to inspire new project ideas 


and keep the whole cycle going,” 
Kristine continues. 

“My top-secret plan is to build 
more engineers,” discloses James 
McLurkin, Senior Hardware 
Engineer of AIY Projects at 
Google. “Getting kits like this out 
into the world with Raspberry Pi 
allows us to build the things that 
then create more engineers.” AIY 
Projects enables young makers to 
explore the possibilities with AI. 
“So this is very exciting for us,” 
says James. 
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“What’s interesting about 
the maker environment is what 
happens when we shut up, and 
listen, and see what people try,” 
says Blaise. Historically, there 
have been many ‘Hello World’ 
types of starter projects for various 
programming languages and 
platforms, and in recent years we’ve 
seen exciting new hardware like the 
Raspberry Pi emerge. Now there is 
Al, another technology for makers 
and developers to add to their 
projects. AIY Projects brings these 
three things together, which will be 
“super interesting,” reckons Blaise. 
“T don’t know what will come out 
from the mixture of those, but I’m 
very keen to see.” 


We want to show you 
how easy It 1s to use Al 


“T view this as an essential 
component in a maker’s toolkit,” 
Billy tells us. “We want makers 
to see that using Al is not hard 
or complex.” 

The Australian artist Stelarc has 
said that technology constructs 
our human nature. “We would 
not be who we are if we hadn’t 
invented fire and woven clothes 
and built Raspberry Pis,” says 
Blaise. “That is what being 
human is all about, 


The Voice HAT allows 
makers to create Voice 

User Interfaces that can 
control their projects 


AlIY PROJECTS 


The AIY Projects team meet up with The MagPi and 
Eben Upton at Pi Towers 


and that’s what distinguishes us 
from the other animals. So I don’t 
like this idea that talks about Al as 
a competitive landscape of human 
exceptionalism, and ways that it 

is being eroded. That really misses 
the point of what all this is about.” 

“This first kit showcasing voice 
is just the start of our effort to 
bring Google AI to the maker 
community,” reveals Billy. “Our 
projects will largely focus on 
Natural Human Interaction.” 
Following voice, we intend to 
feature projects with vision, 
motion, and learning.” 

Google wants makers to add Al 
to their own projects, and share 
their results with others. “We 
want to learn what this community 
needs,” says Billy, “and then work 
with them to build the 

~ @ 


tools they want.” 
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Construct your free 
ATY Projects voice kit 
and explore natural 
language recognition 


nside the kit will be the 
components you need to build 
a voice-capable device with 
Raspberry Pi. 
Open the box and you’1] find two 
pieces of cardboard, an arcade- 
| style button, a speaker, and some 
cables, along with a HAT (Hardware 
Attached on Top) board and another 
narrower board. One is to connect all 
the accessories together; the other is 
: a stereo microphone. 
All of these components fit 
together to build the AIY Projects 
kit: a small cardboard device with a 
colourful button on the lid. You press 
the button, or clap your hands (or 
create a custom trigger), and speak 
: out loud to ask the device a question. 
| The speaker, at the front, then 
announces the answer. 
Tucked inside the cardboard device 
are all the components. Use the Bill 
Of Materials list below to check you 
have all the components. 
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ith all your parts ready, 
it’s time to build the AIY 
Projects voice kit. The aim 
is to assemble all the included 
parts (and a Raspberry Pi board) 
and create a small cardboard 
device with a button on top. 

This project is a relatively easy 
build, and you won’t need to 
solder any of the components. 

Be careful to line up the wires 
correctly, especially the wires 

for the button. It’s also a good 
idea to take a close look at the 
Voice HAT accessory board (the 
larger board). The Voice HAT is 
the heart of the AIY Project kit, 
and everything connects to it. It 
also provides breakout GPIO pins, 
organised into two blocks: Servos 
and Drivers. 

You’ll connect the Voice 
HAT accessory board to your 
Raspberry Pi via the GPIO pins. 


The Raspberry Pi is the brains of 
the outfit: it connects to Google’s 
cloud services through a local 
Python application. The Python 
source code is provided with 

the software image, as well as 

on GitHub. 

Also take a close look at the 
smaller microphone board, 
which enables the device to hear 
you speak. 

But first, we need to get it all 
assembled. The first step is to 
mount the Voice HAT accessory 
board to your Raspberry Pi, and 
then connect the speaker and 
microphone. Then you’|l move on 
to folding the cardboard case and 
placing the components inside. 
Finally, you’ll assemble the 
arcade-style button and secure it 
(and the microphone) to the case. 

Ready? Let’s start building 
your kit. 
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- Raspberry Pi 3 - Small, needle-nose pliers - Phillips 00 screwdriver » Scotch tape 


SET UP THE 
VOICE HAT 


€} INSERT THE 
STANDOFFS 


Start with the two standoffs. These are the small 
plastic cylinders, and they fit into the yellow 
mount holes on the Raspberry Pi board. Insert 
the standoffs into the two yellow holes on the 
opposite side from the 40-pin GPIO header (on 
the same side as the HDMI connection). Push 
them firmly, and they will hold in place. 
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© SCREW IN 
THE WIRES 


At this point, the two wires will be sitting 
in the sockets unsecured. Hold the wires 
in place, and gently turn each screw in 
the socket using a Phillips 00 screwdriver. 
Gently tug on the wires to make sure 
they're secure. Now place the speaker to 
one side of the board so you can access 
the other components. 


SECURE THE HAT 


@ ATTACH THE 
SPEAKER WIRES 


Take a close look at the Voice HAT 
accessory board and find the blue 


terminal with two small screws. This 
terminal is the speaker connection (it 
has ‘Speakers’ printed above it on the 
board). Each of the two connections 
has a small ‘+’ and ‘-’ symbol printed 
below. Find the speaker with the red 
and black wires attached. Insert the 
red wire into the positive ‘+' terminal on 
the Voice HAT accessory board. Now 
add the black wire into the negative 
‘-" terminal. They won't be fixed yet, so 


hold them in place. 
Now get the Voice HAT accessory board and : lial tad 


attach it to the GPIO pins on the Raspberry Pi 
board. Carefully line up the GPIO connector 

on the Voice HAT accessory board with the 
pins of the GPIO header on the Raspberry Pi. 
Gently press down to make sure the Voice HAT 
accessory board is secure. Press down on the 
spacers on the other side of the board to snap 
the boards together. 
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THE BUTTON CABLE 


Find the 4-wire button cable: it has a 
white male connector on one end and 
four separate wires with metal contacts 
on the other. Insert the white plug into the 
matching white socket marked ‘Button’ on 
the Voice HAT accessory board (it is the 
one nearest to the red button). The cable 
will only go in one way around, so don't 
force it. Check that the colours of the cable 
match the image. Don't worry about the 
four separate wires with metal contacts; 
we'll come back to these later. 


@ THE MICROPHONE CABLE 


Find the Voice HAT microphone board 


and the 5-wire daughter board cable. 
The cable has matching white plugs 
on either end. Both ends of the cable 
are identical, so take either end of the 
5-wire connector cable and slot it into 
the Voice HAT microphone board. It 
will only fit one way around. Snap the 
cable in, but don't force it. 
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Do the same for the other folds, tucking FOLD 4 
underneath to secure it in place. Now set it aside. 
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Find the other cardboard piece that came with your kit 
(as shown in the picture). This piece will build the inner 
frame to hold the hardware. Fold the flaps labelled 1 

| and 2 along the creases. 


The flap above the 1 and 2 
folds has a U-shaped cutout. 
Push it out. 


Find your speaker (which is now 
attached to your Raspberry Pi 3). Slide 
the speaker into the U-shaped pocket 
on the cardboard frame. 


Turn the cardboard frame around. Take the 
Pi + Voice HAT hardware and push it into 
the bottom of the frame below flaps 1 and 
2 (pictured). The cardboard frame should 
expose the USB ports of the Raspberry Pi. 
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& PUT IT ALL TOGETHER 


It's time to put the build together. First, remove the SD card 
from your Raspberry Pi to prevent damaging it. Now take the 
cardboard box you assembled earlier and find the side with 
the seven speaker holes. Slide the cardboard frame and 
hardware into the cardboard box. Ensure that the speaker is 
aligned with the box side that has the speaker holes. 


€) CHECK THE PORTS 


Check the holes in the cardboard 
box. The Raspberry Pi ports 
should be clearly visible. 


The AlY Projects voice kit is designed 


to work without a display, but you 
can access the HDMI socket for 
troubleshooting. This hole also 
provides access to the power socket. 


6 CHECK THE WIRES | 


Once it’s in, the Raspberry Pi 
should be sitting on the bottom 
of the box. Make sure your wires 
are still connected. 


One hole provides access 
to the USB ports. These 
ports enable you to hook 
up a keyboard and mouse 
to the AIY Projects kit, 
although it is designed to 
be controlled hands-free 
with your voice. 


@) PACK THE 
ARCADE BUTTON 


Find your arcade button. There will bea 
plastic button, a spacer, and a nut. If they're 
connected, unscrew the nut and spacer from 
the main button and place them to one side. 


€& THE BUTTON LAMP 


Next, we're going to assemble the button 
lamp. This lamp lights up the button and 
displays the status of the device. There 
are three principal components to use: 
Lamp, Black Microswitch, and Black 
Lamp Holder. Make sure you have all 
three to hand. 


&&) INSERT THE LAMP 


AlIY PROJECTS 


ADD THE BUTTON [20 
Insert the plastic button into “4 
the top flap of the cardboard as _f 
box from the outside in. The 
pushable button side should 

face outward, with the larger 

screw on the inside; i.e. the side 

marked ‘BUTTON Spacer first’ 


@) SECURE 
THE BUTTON 


Now take the spacer 
} and add it to the screw. 
Next, screw in the washer 
to secure the button in 
place. Make sure that 
me) thespacer sits between 
the washer and the 
cardboard lid. 


Re ee 


Insert the Lamp into the Black Lamp 
Holder. Look at the image to see which 
way around it fits. The light should face 
outwards. You may need to adjust the 
rotation later to get a good connection. 


@&) ATTACH THE LAMP 


Now attach the Black Lamp Holder 
(with the Lamp) to the Black 
Microswitch component. Two 


protrusions on the Black Lamp 
Holder match the indentations on 
the Black Microswitch. Observe the 
position of the red button on the 
Black Microswitch component. Clip 
the two parts together. 
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You now have a completed lamp with a microswitch 
mechanism. Look at the button to see spacers that press 
down on the red microswitch. When you press the button, it 
pushes the microswitch. Insert the lamp into the button. 


Locate the four coloured wires 
with metal contacts that you 
previously connected to the 
Voice HAT accessory board. 
Using the annotated 
picture, attach the four 
metal contacts to the 
corresponding metal 
contacts on the Black 
Microswitch. Connect 


p- Mee - - 


the wires to the contacts 
using this guide. 
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installing the software and using the Google Assistant to — 
answer your questions. Fold the top flap down 


That's it. Your voice kit is assembled, and you can now start = 
to close the box up and admire your handiwork. 
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SDK to create 


Use the Google Assistant 
a device that answe oad our -. estions 
and helps you get 


You ll Need 


ou now have a fully 
assembled cardboard 
device that is almost ready 
to respond to your questions. 

To do this, you’ll set up a Google 
Developer project and activate the 
brand-new Google Assistant SDK. 

Google has provided a 
Python sample application that 
demonstrates how to use the 
Google Assistant SDK. To set it 
up you’ ll need to download the 
AIY Projects image file from 
alyprojects.withgoogle.com/voice/. 

Burn the image file to a microSD 
card using a program like Etcher 
(etcher.io). This software copies 
the image file to the SD card (see 
‘Burn SD cards with Etcher’, 
magpi.cc/2fZkyJD). 


- Assembled AIY 
Projects kit 


¢- MicroSD card 


- AIY Projects 
image file 


- Google account 


>STEP-O1 

Set up the SD card 

Insert the SD card and connect 
the power. The software image 
is based on Raspbian, so it feels 
familiar. Alternatively, you can 
replace it with a software image 
based on Android Things. For more 
information on using Android 
Things, visit the AIY website 
(aiyprojects.withgoogle.com/ 
voice). 


>STEP 2 

Set up the network 

Click on the Networking icon and 
choose your network. Now double- 
click the ‘Check WiF?’ icon. 


>STEP 3 

Check the audio 

Next, double-click the ‘Check 
audio’ icon. If there is a problem, 
check the Voice HAT accessory 
board’s connection to the speaker 
and microphone. 


>STEP 4 

Set up the cloud 

Open the Chrome web browser and 
click on Google API Console in the 
Bookmarks bar (or enter 


console.cloud.google.com in 
the URL field). Enter your Google 
Account ID and click Next (or 
create a new account). Enter your 
password and click ‘Sign in’. 


>STEP 5 

Create a project 

Click the menu icon marked 
‘Project’ and choose ‘Create 
project’. Give the project a name, 
like ‘aiyproject’, and click Create. 


>STEP 6 

Enable the services 

Click on the ‘Products & services’ 
menu and choose API Manager. 
Search for and click Enable API at 
the top of the screen. Click Google 
Assistant API and click Enable. 
While you’ re here, select Speech 
API and click Enable. 


>STEP 7 


Set up OAuth consent 

Click on Credentials in the API 
Manager sidebar (on the left) 

and choose the ‘OAuth consent’ 
screen tab. Enter the name of the 
app, such as ‘ATY Project’, in the 
‘Product name shown to users’ 
field. Click Save. 


>STEP 8 

Create OAuth client ID 

Click Create Credentials and 
select ‘OAuth client ID’. Choose 
Other and click Create (it will 
be named ‘Other client 1’ 

by default). A window will 
appear with your client ID and 
client secret. 


>STEP 9 


Download credentials 

Look to the right of the ‘Other 
client 1’ item and locate the 
download icon. Click the download 
icon to save the JSON file. 


>STEP 10 
Rename credentials 


Open a Terminal window 
and enter: 


cd Downloads 
ls 


You will see a file called 
client_secret_ with a long 
ID number after it. We need 
to rename the file to 
client_secrets.json and move it to 
the home folder. Enter this: 


mv client_secret 


Press TAB to autofill 
the file name and add 
/home/pi/client_secrets.json 
as the destination. The command 
looks like this: 


mv client_secret_[123etc ] 
/home/pi/client_secrets. json 


>STEP 11 


Create service account 

Head back to Google Cloud 
Console in the browser and click 
Create Credentials again. This 
time choose ‘Service account 
key’. Click the ‘Service account’ 


menu and choose ‘New service 
account’. Give it aname, such as 
‘ATY Projects’, and change the 
Role to Project > Owner. Make 
sure the Key type is JSON and click 
Create. The Key is downloaded to 
your computer. 


>STEP 12 

Create credentials 

Find the file you’ve downloaded. 
You need to rename the file 
credentials.json and place it in 
your home folder. 


mv aiyproject-[123etc ] 
/home/pi/credentials. json 


>STEP 13 

Activity controls 

In your web browser, visit 
myaccount.google.com/ 
activitycontrols. Sign in using 
the same account and turn each 
of these items on: 


¢ Web & App Activity 

¢ Location History 

¢ Device Information 

¢ Voice & Audio Activity 


These are required for the Google 
Assistant to run. Now close the 
browser window. 


>STEP 14 


Start the voice unit 
Double-click the ‘Start dev 
terminal’ icon and enter: 


src/main.py 


A Request for Permission window 
appears. Click Allow. Copy the code 
from the web browser and paste it to 
the command line in the Terminal 
window. Press RETURN and you will 
see ‘Press the button on GPIO 23 


then speak, or press Ctrl+C to quit...’ 


>STEP 15 

Push the button 

Push the button on the top of your 
device and it will display: 


[INFO]main: listening... 
[INFO |main:recognizing... 


Ask the device a question, 
such as “what is the weather 
in Cambridgee” 

The AIY Projects voice kit speaks 
out the answer. Keep pushing the 
button and asking questions. Press 
CTRL+C when you’re done. 
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>STEP 16 
Clap your hands 
You can set up the voice-recognizer 
to respond to hand claps. Enter this 
command in the Terminal: 


nano /home/pi/.config/voice- 
recognizer.ini 


Now remove the # before this 
line of code: 
trigger = clap 


Press CTRL+0O and press 
RETURN, then CTRL+tX. 


>STEP 17 

Listen on boot 

Now set up your device to start 
listening automatically. Double- 
click ‘Start dev terminal’ and enter 
the following command: 


sudo systemctl enable voice- 
recognizer 


The Terminal displays ‘Created 
simlink from’ messages. Finally, 
reboot your Raspberry Pi. 


Gndroldthings 


Android Things is a new OS for connected devices 
that is fully compatible with the AIY Projects kit that 
you received. Developed by Google, it is a ready-to- 
use solution for building connected devices. 

Developers can use existing Android development 
tools, security updates, APIs, resources, and a thriving 
developer community. It also includes new Android 
framework APIs that provide low-level 1/0 and 
libraries for common components like temperature 
sensors and display controllers. 

In addition, a wide range of Google APIs and 
services, such as Google Play services, TensorFlow, 
and Google Cloud Platform are available on Android 
Things. Developers can push Google-provided OS 
updates and their own app updates, using the same 
OTA infrastructure used on Google's own products. 

To get started on building your kit with 
Android Things, visit the AIY Projects website 
(aiyprojects.withgoogle.com/voice). More 
information about Android Things is available on the 
developer website (developer.android.com/ things). 
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Swap out traditional interfaces with a custom 
| 


C) Google Cloud Platform ee ee 4. 
voice control using your AIY Projects voice kit 


y now, you have built a trigger and which API to use for 
device that embeds the voice recognition. Don’t worry: If 
Google Assistant. That’s The source code for the voice- you mess it up, there’s a backup 
cool, but it’s just the beginning. recognizer app is part of the copy kept in home/pi/voice- 
With Google Cloud Speech API, image that you’ve just installed. recognizer-raspi/config. 
you can create an interactive, You can view the Python source 
= — custom Voice User Interface (VUI) code in the /home/pi/voice- 
Cee nek suey § for your project. recognizer/raspi/ directory. 
pT NR: ee at as Tah eo | This enables you to explore a You should already have the 
! oa i 58 Hii oe ees new generation of devices that credentials.json file in your 
1% a Pe | you can have a conversation home directory. We installed 
Osa Oe aly ey tite with, without the need for The application can be configured this in the previous tutorial. This 
; remote-control devices (such as by adjusting the properties found provides access to the Google 
joysticks or smartphone apps). in /home/pi/.config/voice- Cloud Speech API. Double-click 
Let’s reconfigure the kit to use recognizer.ini. This file lets you the Check Cloud icon on the 
ei AN re the Google Cloud Speech API. configure the default activation desktop to test the Google Cloud 
ote as . Speech API. If it says ‘Everything’s 
set up to use the Google Cloud’, 
close the Terminal window and 
skip ahead to Step 5. 
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If you do not have credentials.json 
in your home directory, open the 
API Manager in Cloud Console and 
choose Create Credentials > Service 
account key. Select your project 
under Service Account or choose 
New Service Account (give it a 
name and set the Role to Project 

> Owner). Choose JSON as the Key 
Type and click Create. Rename the 
file to credentials.json and place it 
in your home directory. 


You need to have the Cloud 
Speech API enabled to use the 
service. Open the API Manager 
in Cloud Console and choose 
Library. Click on Speech API and 
click Enable (if you see Disable, 
it’s already enabled and you can 
move on). 


You need to have billing set up 
with Google to use the Cloud 
Speech API. Open Cloud Console. 
If you don’t have a billing account, 
click ‘New billing account’ and 

eo through the setup. Check your 
project is selected in the Projects 
menu at the top. Click Products & 
Services > Billing. To connect or 
change the billing account, click 
the three-dot button, then select 
‘Change billing account’. 
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It’s time to turn on the Cloud 
Speech API. Editing the config 

file enables you to switch from 

the Google Assistant SDK to the 
Cloud Speech API. Open a Terminal 
window and enter: 


Delete the # before this line: 


Press CTRL+O, press RETURN, then 


CTRL+X to save and exit. Now enter: 


Open ‘Start dev terminal’ and enter: 


You can now issue a limited 
number of commands: 


What are the three laws of robotics? 


Hello 

What time is it? 
Volume up 
Volume down 


Press CTRL+C to quit the interaction. 
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(the leftmost pin marked 0 under as 2 ey uF ‘ * ae os 
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add action.py code to src/action.py: 


Then add the following main.py 
code to src/main.py under other 
calls to actor.add_keyword: 


You can discover more information 
on using the GPIO pins at 
alyprojects.withgoogle.com/voice. 
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What makers around the world are building 
with the AIY Projects voice kit 
your AIY Projects voice kit, 


wueavroecwierks MAGIC MIRROR 


Natural Human Interaction to your Add a Voice User Interface to a mirror 


y now you will have set up 


projects. Wow! display for the ultimate creative assistant 
The question is: what are you 

going to build? What projects will magpi.cc/2nwpxBA 

be amazing with voice controle 


The good news is you’re not Michael Teeuw’s Magic Mirror came first in our Top 
alone. Thousands of members of 50 list of greatest projects. 
the Raspberry Pi community will be Perhaps the only thing that could make this 
building Natural Human Interaction project more awesome would be voice control. 
projects. And we want you to share The good news is that Magic Mirror has a 
them with us, and each other. powerful community behind it. And they’ve already 
To get the ball rolling, Google been busy working with voice interaction. 
has been running a Hackster MMM-Hello- Mirror, by a user known as 
community for Google Beta Matzefication, is a voice control system for the 
Testers. These lucky makers were Magic Mirror based on Google Speech Recognizer 
sworn to secrecy and received an (magpi.cc/2nwyGtO). The AIY Projects kit will 
AIY Projects voice kit early. make a Voice User Interface a real possibility. 
We asked members of the Your reflection has never looked smarter. 


Hackster group and members 
of the Raspberry Pi community Adding voice control to the Magic Mirror 
working in voice control what they makes it more naturally interactive 


thought the best ideas for projects 
were. Here are their suggestions 
for projects they’d like to build. 
Now it’s your turn. Create 
something amazing and share it 
with the Raspberry Pi community 
on Hackster (magpi.cc/20Px6nb). 
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“T have one of these Nabaztag 
IoT devices,” says Bastiaan Slee. 
“They were ahead of time and 
didn’t survive. Now it’s time to 
give it a new breath.” 

Bastiaan plans to use servos 
to move the ears, LED lights for 
notifications, and perhaps add a 
camera and ultrasonic sensor to 
sense the nearby presence of a 
person. “If there is still space in 
his body, who knows what more 
will be added?”’, he tells us. 


, avy > : , ja t . . - ; aes ABO ‘ Ps tte 
hy oe a. 4 yd ha ‘bo a ; +s i ‘ . 7 P’ > ; ’ ¢ ‘ o ree 
: ; A iS 2 OAT een os oF EGOS Cie f E f , <7 yy! or ao ¢ PT aeitine oe hie sete: Prey tlh) 


«LD foot f ; ‘? y ie ' Us Ln y / / . *<. RY Done oe "a are y, 5s AE See p P : 3 ig) hice ane ei Toy, 
; : Bit AG tise Wie Care EES ; 
«May 2017 MagPi | -3 


< saspbertypiorg/magpl Bireee 
(Os Pie te (bia ce int mA asd: ent 
7 ur (a, K 53 , tin ; ses ‘ fh ‘ ; J Saleh ty 3 » ¢; Bac ” i bir, f re >. 2.3 4 J j . fe é ‘y > : +. ue f eek oe ¥ Pe 


, 
SUBSCRIBE TODAY AND RECEIVE A 


me 
fa, 
ie; 
my 
ia) 
ee 
aa 


= i 
= t 
4) i td kes 
Tih 
al, 
- 
2 
eee 


Subscribe in print for 12 
months today and receive: 


A free Pi Zero W (the latest model) 


Free Pi Zero W case with three covers 
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Free Camera Module connector 
Free USB and HDMI converter cables 
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Other benefits: 
Save up to 25% on the price 


Free delivery to your door 


Exclusive Pi offers and discounts 
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Since his last thermal printing camera 
build, the release of the Pi Zero 
allowed Pierre to shrink the build size 


» Pierre installed 
an on/off 
switch for 
shutdown 


» He printed 
the case via 
an online 
3D-print service 


» Everything is 
available from 
his GitHub repo 
magpi.cc/ 
2ndslE3 


» You can 
navigate past 
images via 
button press 


» Watch the 
camera in 
action here 
youtu.be/ 
8D-sL3GoFZM 
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The small size of the Adafruit 
Nano Thermal Printer makes 
it the perfect partner for the 
Raspberry Pi Zero 


Pierre kept the LCD display in 
black and white to give a better 
impression of the final print result 


PI-ZERO 


The tiny Zero-powered thermal-printing camera that recreates 
the joy of using a Polaroid 


Inve IPCkel eal Zeiee) iS Wine 

second iteration of Pierre 

Muth’s exploration into 
portable photography with the 
Raspberry Pi and thermal printer. 
No stranger to thermal printing 
builds, he’s previously created 
such wonders as a camera booth 
lottery ticket system. Take your 
photo and if your thermal printout 
displays another’s face, locating 
them grants you both a free beer. 

So while his original PolaPi 
model also housed a Raspberry 
Pi — the version 2, with a full-size 
casing — the newer model allows 
for a smaller body with its use of 
Le [Reals dloveininy 12M Zein), 
We’ve seen many digital camera 

builds using the Raspberry Pi and 
Camera Module. From 3D-printed 


cases to retrofit vintage classics, 
the majority act as simple point- 
and-shoot cameras. The PolaPi- 
Zero, however, takes its lead 

from the iconic Polaroid camera, 
utilising a thermal printer inside 
its body to deliver instant prints of 
your subject matter. 

In his original PolaPi build, 
Pierre had been forced to 
cannibalise a retail-grade thermal 
receipt printer, leaving the unit 
bulky and weighty. With the new 
model, following in the footsteps 
of the small-bodied Raspberry Pi 
Zero, he managed to acquire the 
Nano Thermal Receipt Printer 
from Adafruit: a smaller device 
marketed specifically for use with 
boards such as the Raspberry Pi 
and Arduino. Coupled with a Sharp 
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Tite: Pola? i-Zero 


>STEP-01 
The inside 
The schematics for the build are similar 


to Pierre's original camera. The only 
differences are the added LCD screen 
and buttons for reviewing previously 
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>STEP-02 

The outside 

Pierre designed the case and used an 
online 3D-print service to complete 
the process. The white colouring of the 


camera is, in part, ahomage to the White 


>STEP-03 


The PolaPi-Zero 


Pierre used the opportunity to utilise 
new, smaller components as a means to 
simplify the overall technical build and 
add extra features, such as the ability to 


captured images. 


memory LCD, the camera allows 
its user to see the image on screen 
in black and white before printing, 
euaranteeing the quality of the 
photograph before you commit to 
(elke) “Suen. 

Pierre used the project as 
“a good excuse to start learning 
Python (finally)”, in part due to 
the array of existing Python code 
available online. His original 
camera ran using Java, and though 
he admits to the final Python code 
not being “the most elegant”, he 
provides it via both his GitHub repo 
(magpi.cc/2ndslE3) as complete 
code, and as a downloadable image 
for the Raspberry Pi Zero. 

For the physical body of the 
camera, Pierre designed the unit in 
Autodesk 123D before sending it to 
an external 3D printing company, 
3DHubs.com, for completion. 


Box artwork by Vit Hasek. 


Again, he provides the case 3D 
print files in his GitHub repo. 
Completing the build with a Pi 
Camera Module, a7.2V battery 
with voltage regulator, anda 
handful of buttons, the PolaPi- 
Zero is good to go, providing 
instant gratification to any user 
wishing to immortalise their 
photography on receipt paper. 


So what next? 

With the technology in place, 
Pierre started to experiment with 
different styles of image capture. 
Starting with the idea of slit-scan 
photography, where a movable 
Slide with a slit cut in it is passed 
between the lens and subject 
matter, Pierre played around witha 
coded variant. The result is an odd, 
stuttered image effect that varies 
depending on whether the scan 


view previous images. 


reads horizontally or vertically. 
The continuous length of the 
thermal camera paper allows this 
effect to be captured and printed. 

Pierre claims to live “always 
with the hope to make something 
and not just use something”, and 
as his interesting builds continue 
to wow us, we look forward to 
seeing what comes next. 


Examples of 

the slit-scan 
photography that 
Pierre has been 
experimenting 
with using the 
PolaPi-Zero 
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Windows 98 
is emulated 
using QEMU 


It takes several 
minutes to 
boot up 


The Pi A+ is 
overclocked 
at 800MHz 


Michael wants 
to make a Pi 3 
version 


He's also 
working on 
a Robo Skull 


MICHAEL DARBY 


A tech nerd from a young age, 
obsessed with computers and tech, 
with a dream to one day be like 
Tony Stark. 

314reactor.com 


WINDOWS 92 


WAICH 


Wind back the clock with this chunky wristwatch 


f Microsoft had designed 

a Smartwatch back in 

the late Nineties, it 

might have looked something 

like this! Michael Darby, aka 
314reactor, has built a chunky, 

Pi- powered wristwatch running 
the Windows 98 operating system. 


While he admits the ancient OS 
used to drive him mad back in the 
day, he has an odd nostalgia for it. 
“Many years later you look back 
on it and want to relive it. I think 
time has a funny way of keeping 
more of the good than the bad 
within memory.” 


Once he’d accrued the required 
components, including a 
Raspberry Pi Model A+, it only 
took a few hours to put together. 
There’s a tutorial on his site: 
magpi.cc/2nX9ss4. The Pi A+ 
sits in the bottom of an Adafruit 
Pi Protector edse wit allie 
2.4-inch HAT touchscreen on top. 
Five tactile buttons have been 
added to the latter, although only 
one is currently used — to shut 
down the system cleanly. The 
watch is powered by a slimline 
LiPo battery connected viaa 
PowerBoost 500 with switch, while 
Velcro feet secure the watch body 
to a wrist strap. 

Emulation is employed to get 
Windows 98 working on the 


watch, using the QEMU hypervisor 
running in Raspbian. “Its relatively 
simple,” says Michael. “Once 
you’ve set up a QEMU environment 
on another PC and installed 
Windows 98 to it, it’s a case of 
dragging the virtual hard drive 


A LiPo battery, hidden 
underneath, powers the 
Raspberry Pi A+ and touchscreen 


Buttons have been added to the 


PiTFT screen, although only one 
is currently used 


Emulated using QEMU, Windows 
98 really works, albeit slowly 
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Remember this? The classic ‘flying windows’ screensaver 


file over to the Pi and running 
it there.” 

When the Windows 98 system 
eventually boots, it really does 
work, although Michael admits 
it’s too slow to be usable and 
touchscreen navigation is tricky. 
“T need to look into calibration, 


virtual graphics card on QEMU on 
the Pi that will allow Windows 98 
FO mln 1, Sle ce lone, ~ 

While Michael has considered 
using a Pi Zero for the watch, 
he has a different plan for an 
upgraded version: “It could be 
made marginally slimmer witha 


I can potentially put a bigger 
screen on and have multiple 
operating systems selectable 


I think, or it could be an issue 

with the way QEMU works when 

launched from the command line.” 
Even so, Michael is eventually 

hoping to get classic 3D shooter 

Doom running on the watch, once 

he’s overcome a technical issue: 

“I can’t find a way to create a 


An AdaFruit 2.4” PiTFT touchscreen, 
with added push buttons, is mounted 
on the Pi 
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Pi Zero and it would give a bit of 
a speed boost... 1am thinking of 
going the other way, though, and 
using a Pi 3 in future.” Although 
this would be even bulkier, it 
would run a lot faster as the Pi 3 
handles emulation far better. “I 
can potentially put a bigger screen 
on and have multiple operating 
systems selectable from the 
buttons, such as 95, XP, and even 
something out there like ReactOS 
or some random Linux distro.” 

In the meantime, Michael 
has received plenty of positive 
feedback for his Windows 98 
Watch, which he wore to Raspberry 
Pi’s Fifth Birthday Bash. “The 
reaction has been crazy; I never 
expected it to take off like it did, 
but I’m very happy it did and it has 
inspired me to create more and 
work harder.” 
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A Camera Module scans the printer 
order as it comes through. This 
scan is used to provide a backup 


The Raspberry Pi, housed inside 
the box, hosts an Apache web 
server to provide web access 


>» Waiting staff 
use an Amazon 
Fire HD to 
take orders 


» The Khyber 
Tandoori is 
a 50-seater 
restaurant 


» The online 
system took 27 
orders in its first 
two weeks 


>» The EPOS 
system has 
been in use for 
eight months 


» Customers get 
live updates on 
waiting times 
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How one Indian restaurant used Raspberry Pi 
to automate its whole kitchen ordering system 


help at my father’s 

restaurant on Friday and 

Saturday evenings,” says 
Ehsan Rahman. 

That establishment is the 
Khyber Tandoori, an Indian 
restaurant based in Kingswood, 
Surrey (magpi.cc/2miqcqv). 
Thanks to the Raspberry 
Pi, it has become a highly 
automated environment. 

Two years ago, Ehsan became 
frustrated at writing orders on pen 


and paper. Ehsan’s answer was to 
code and hack his way out. 

The result is PiOrder, a fully 
automated EPOS (electronic point 
of sale) system. PiOrder comprises 
Raspberry Pis, several Pi Camera 
Modules, and a Pipsta thermal 
printer (magpi.cc/2miwYMQ). 

The waiting staff use large Kindle 
Fire tablets to take orders. Two 
smaller tablets are kept near the 
phones so staff can take orders 
Over Lae Welleolvome. 


The Pipsta printer is used to print 
out the order. The kitchen staff tear 
off the order and cook the food 


In the kitchen is a Raspberry Pi 
board hosting the Apache website. 
A program written in PHP and HTML 
is used to provide the webpages. 

Apache is used to host the 
webpage used by the waiting staff 
to take orders. It also offers online 
ordering for takeaway customers. 

Chefs are alerted to new orders 
via a Speaker attached to the 
Raspberry Pi. 

The Pipsta printer also prints 
a hard copy of the order, anda 
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Raspberry Pis with Camera Modules 
provide CCTV for the restaurant, which 
can be viewed using the system 


Camera Module takes a photograph 
of the order to ensure it has 
printed out correctly (and to act as 
a backup). More Camera Modules 
are used by managers to keep an 
eye on how busy the kitchen is. 

As well as making Ehsan’s 
waiting duties easier, PiOrder 
saves on costs. “Just Eat charges 
approximately £699 + VAT just for 
signing up,” reveals Ehsan. Then 
it charges around 11% per order, an 
amount that rapidly racks up. 

More importantly, “we have 
control over our software and order 
flow,” adds Ehsan. 


the system has “been resilient.” 
There’s an automated test every 
day at 5:30 for a single popadom, 
“so the chefs and waiting staff 
know the system is up and 
working,” explains Ehsan. 

There are even spare Raspberry 
Pi boards in case of failure. “But 
I’ve not needed them yet after two 
years,” Ehsan reveals. 

As aresult of all this tinkering, 
the restaurant is incredibly high- 
tech. As well as the ordering 
system, they are using Raspberry 
Pi Model B boards as smart CCTV 
cameras. Ehsan has even set up a 


The chefs would not go back 
to reading handwritten orders 


ever again 


The system is a mixture of PHP, 
JavaScript, and jQuery, with Bash 
Scripting used to communicate 
between the Raspberry Pis. “The 
ereat thing about Unix files is just 
how reliable they are,” says Ehsan. 

The other waiting staff and 
Ehsan’s father have completely 
stopped using pen and paper. 

There were some teething 
troubles: the original WiFi 
system occasionally dropped 
the connection, and the Pipsta 
struggled to print large orders. 
But after sorting those issues, 
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Raspberry Pi3 to act as a remote 
monitoring system, “so my father 
can see how busy the restaurant is 
from home.” 

Ehsan isn’t finished. He plans 
to enable customers to order 
food from their table using a 
smartphone or tablet. 

“The chefs and my father were 
not convinced at first, but slowly 
they saw the benefit.” The waiting 
staff love the ability to update 
orders with just a few taps. And the 
chefs would not go back to reading 
handwritten orders ever again. 
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Orders 


Online Orders 


2 Lime: ZO min - 21:28:22 


fer: 0 Total Today: 0 
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Audio from the four Pi Zeros’ 
USB sound cards is sent to an 
external amp and speakers 


Arcade buttons are used in A layer of smooth plastic protects 
place of traditional piano keys y the keyboard and its user 


TOUGH PI-ANO 


Hammer the keys on this incredibly robust musical instrument 


rian McEvoy wanted While Brian contemplated perfect piano replica with easily 
to make a toughened the Tough Pi-ano’s design for replaceable octaves, he started 
electronic keyboard forhis two years, it only took hima crafting wooden piano keys. After 
Ona nee 48 cousin, who has Down’s syndrome: couple of weeks to build, putting experiencing too many problems, 
‘keys’ in total “He loves music therapy but he his woodworking skills to however, these were replaced 
. Itwill be used breaks pianos on a weekly basis.” eood use. “Keeping everything with plastic arcade buttons. “In 
for music Brian’s aunt asked him to help simple was integral to making the end, arcade buttons were the 
therapy with therapy devices for his cousin a solid structure.” Since the best solution since they were easy 
> The keys are and other such kids. “The ideawas __ original design concept was for a to source and replace.” 
plastic arcade exciting because there is a whole 


buttons ; nee: 
different mindset when designing 


for someone who will not handle 
controls f : 
each octave things with gentle hands. These 


» APi Zero 


Fhelee sound projects have to absorb damage 
Sarde cost without hurting anyone.” 
$0.99 each The result is the Tough Pi-ano. 


It has no exposed metal, and the 
keyboard area is covered with thick 
plastic. For its keys it uses arcade 
buttons, which are inexpensive and 
easy to replace. Each of four octaves 
is powered by a Pi Zero, with a USB 
sound card outputting the audio to 
an external amplifier and speakers. 


Twelve arcade buttons are wired 
to each Pi Zero, via a resistor board 
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TOUGH PI-ANO ‘Projects 


on the keys so they were, of course, M AKE A 
rone to floating. At that point, I 

a inadvertently built a touchless TOUG H PIANO 
piano,” recalls Brian. 1K resistors 
were added to each input to solve 
the problem. “There is still some 
noise on the audio despite using a 
clean power supply and line filter. 
Maybe using So.99 USB audio cards 
is to blame.” 

While Brian admits it would 
have been possible to use a single 
Raspberry Pi and remote I/O to 
power the piano, the use of one Pi 
Zero per octave has some benefits: 
“Tf any part was to break, it would 
be possible to shuffle working 
hardware around for a three-octave 
Tough Pi-ano, at least until repairs 
could be made. So there is still an 
advantage to the redundancy.” 

Brian’s Tough Pi-ano is now set to 
be used in his aunt and uncle’s new 
centre for local families with kids on 
the autism spectrum and those with 
Down’s syndrome. While he doesn’t 

Brian wrote a Python program plan to build another piano, he has 
using the Pygame library toreadthe some advice for would-be makers. 
arcade button presses and play WAV “I would recommend building the 
piano samples. While he considered — speakers into the enclosure, but 
adding a3.5mm jack toeach Pi Zero, be sure to ventilate the amplifier. 


In the end, arcade buttons were 
the best solution since they 
were easy to source and replace 


he eventually opted to use cheap Also, buy one of the tools used to 
USB sound cards to output the audio. fasten arcade button washers, or 
The biggest problem was electrical you’ ll regret it when you get to the 
noise. “The first octave I built 50th button and your knuckles 
didn’t have any pull-up resistors are bloody.” 


The 1K resistor 
boards were 
added to reduce 
issues with 
electrical noise 
rs] 60000006 
333333 
*99080000G6¢e a+ 
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>STEP-03 
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Get off to a good start with Minecraft: Pi Edition. 
Play the game and write your first program using the API. 


The mouse changes where you look 

Holding the left button destroys blocks 

Right button places blocks 

W, S, A, D move you forward, backward, left, 
and right 

1, 2,3, 4,5, 6, 7, 8 change what you are holding 
E opens the inventory 

ESC takes you back and to the Menu 

SPACE is jump. Double-tapping it makes you fly 
or stop flying 


ka Fred ve = rr 
nNecrea ~!| ef) Of - 5 x 
ex Minecraft - Pi editic [=][=]] 


ello Minecratt Worl d 


Get the player’s position 

Change (or set) the player’s position 

Discover the type of block at a specific location 
Change a block 

Change the camera angle 

Post messages to the player 


Go to the Minecraft menu with ESC, but leave 
the game running (you can minimise it). 
Open IDLE by clicking Menu > Programming > 


WATCH FOR 
; ; RED TEXT 
Use File > New File to create a new program and 


Python 3 (IDLE). 


save it as hellominecraftworld.py. 

At the top of your program, type the following 

code to import the minecraft module, which 

will allow you to use the API and talk to the game: 

import mcpi.minecraft as minecraft 

On the next line, create a connection from your 

program to Minecraft and call it me: 

mc = minecraft.Minecraft.create() 

Use your Minecraft connection and the 

function postToChat() to put a message in 

the chat window on a third line: PYTHON 
mc.postToChat("Hello Minecraft World") IS CASE- 
Run your program by clicking Run > Run Module. SENSITIVE 


All blocks in 
Minecraft have a 
position of X, Y, Z 


Teleport the player by setting their position: 
mc.player.setPos(@, 50, @) 

Run your program by clicking Run > Run Module. 
Quickly switch back to Minecraft to see your 
player fall to the floor (unless in flying mode). 


Tutorial 
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MAKE A 


> GPIO Zero 


> 1x solderless 
breadboard 


> 1x light- 
dependent 
resistor (LDR) 


> 1x 1pF capacitor 
> 1x laser pointer 


> 5x male-to- 
female jumper 
wires 


> 5x female-to- 
female jumper 
wires (optional) 


> 1x drinking straw 


> 1x plastic box 
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PHIL KING 


When not writing and sub-editing 
on The MagPi, Phil loves to work on 
Pi projects. This article is based on 
an official resource by Marc Scott. 
@philking68 @Coding2Learn 


The light-dependent 
resistor (LDR) has 
lower resistance 
when the laser is 
shining onto it 


By timing how long it 
takes to charge the 
capacitor, we can 
work out the light 
level on the LDR 


Asimple piezo 
buzzer is made to 
beep whenever the 
laser tripwire beam 
is broken 


Learn how to use an LDR to detect a laser pointer beam 


he Raspberry Pi can easily detect a digital 

input via its GPIO pins: any input that’s 

approximately below 1.8V is considered off, 
and anything above 1.8V is considered on. An analogue 
input can have a range of voltages from OV up to 3.3V, 
however, and the Raspberry Pi is unable to detect 
exactly what that voltage is. One way of getting around 
this is by using a capacitor, and timing how long it 
takes to charge up above 1.8V. By placing a capacitor 
in series with a light-dependent resistor (LDR), the 
capacitor will charge at different speeds depending on 
whether it is light or dark. We can use this to create a 
laser tripwire! 


Place your laser tripwire across a doorway; 
when someone breaks the beam, the alarm will sound 


Connect the LDR 

An LDR (also known as a photocell) is a special type of 
electrical resistor whose resistance is very high when 
it’s dark, but reduced when light is shining on it. With 
the Raspberry Pi turned off, place your LDR into the 
breadboard, then add the capacitor. It’s essential to 
eet the correct polarity for the latter component: its 
longer (positive) leg should be in the same breadboard 
column as one leg of the LDR. Now connect this 
column (with a leg of both components) to GPIO 4. 
Connect the other leg of the LDR to a 3V3 pin, and the 
other leg of the capacitor toa GND pin. Your circuit 
Should now resemble the diagram above. 


Test the LDR 

On the Pi, open IDLE from the Main Menu: Menu 

> Programming > Python 3 (IDLE). Create a new 

file by clicking File > New File, enter the code from 
ch8listing1.py, then save it. At the start, we import 
the LightSensor class from GPIO Zero. We then 
assign the variable ldr to the LDR input on the GPIO 4 
pin. Finally, we use a never-ending while True: 
loop to continually display the current value of the 
light sensed by the LDR, which ranges from 0 to 1. Try 
running the code and then shining your laser pointer 
on it to vary the light level. 
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‘ chdlisting! py 


MAKE A LASER TRIPWIRE 


>PYTHON 3 
from gpiozero import LightSensor 


DOWNLOAD: 


magpi.cc/2bhxwxC 


ldr = LightSensor(4) 


while True: 
print(ldr.value) 


chdlisting2.py 


from gpiozero import Buzzer 


Above Shining the laser onto the LDR in a darkened room will 
dramatically affect the measured light level 


>STEP-03 

Enclose the LDR 

Unless you’re working in a darkened room, you’ ll 
probably notice little difference between the measured 
light level when the laser pointer is directed onto the 
LDR and when it’s not. This can be fixed by reducing the 
amount of light that the LDR receives from other light 
sources in the room, which will be essential for our laser 
tripwire device to work effectively. We’ ll achieve this 

by cutting off a short section — between 2cm and 5cm — 
of an opaque drinking straw, and inserting the head of 
the LDR into one end. Now try the test code again and 
see how the measured light level changes when you 
shine the laser pointer into the other end of the straw. 
You should notice a larger difference in values. 


>STEP-04 

Wire up the buzzer 

To create an audible alarm for our laser tripwire, we’ ll 
add a piezo buzzer to the circuit. Again, the polarity 
has to be correct: connect the column of the buzzer’s 
longer leg to GPIO 17, and the shorter leg toa GND 
pin. Let’s test whether it is working. In IDLE, create 

a new file, enter the code from ch8listing2.py, and 
save it. At the top, we import the Buzzer class from 
GPIO Zero. Next, we assign the buzzer variable to 
the buzzer output on GPIO 17. Finally, we use 
buzzer.beep to make the buzzer turn on and off 
repeatedly at the default length of one second. To stop 
it, close the Python shell window while it is off. 


>STEP-05 

Test the tripwire 

We’ll now put it all together so that laser pointer shines 
at the LDR through the straw, and whenever the beam 
is broken, the buzzer sounds the alarm. In IDLE, create 
a new file, enter the code from ch8listing 3.py, and save 
it. At the start, we import the Buzzer and LightSensor 
classes from GPIO Zero. We also import the sleep 
function from time; we’ll need this to slow the script 
down a little to give the capacitor time to charge. As 
before, we assign variables for the buzzer and LDR to the 
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buzzer = Buzzer(17) 
buzzer .beep() 


chdlisting3.py 


from gpiozero import LightSensor, Buzzer 
from time import sleep 


ldr = LightSensor(4) 
buzzer = Buzzer(17) 


while True: 
sleep(@.1) 
if ldr.value < @.5: 
buzzer.beep(@.5, 0.5, 8) 
sleep(8) 
else: 
buzzer.off() 


respective devices on GPIO pins 4 and 17. We then use a 
while True: loop to continually check the light level on 
the LDR; if it falls below 0.5, we make the buzzer beep. 
You can change this number to adjust the sensitivity; 

a higher value will make it more sensitive. Try running 
the code. If you break the laser beam, the buzzer should 
beep for eight seconds. You can adjust this by altering 
the buzzer. beep parameters and sleep time. 


>STEP-06 

Package it up 

Once everything is working well, you can enclose your 
Raspberry Pi and breadboard in a plastic box (such as 

an old ice cream tub), with the drinking straw poking 
through a hole in the side. If you prefer, you can remove 
the breadboard and instead connect the circuit up 
directly by poking the legs of the components into 
female-to-female jumper wires, with the long capacitor 
leg and an LDR leg together in one wire end, connected 
to the relevant pins. Place the tub near a doorway, and 
place the laser pointer on the other side, with its beam 
shining into the straw. Run your code and try walking 
through the doorway: the alarm should go off! 
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A professional tinkerer since 2004, 
Clive just keeps seeing more uses 
for Raspberry Pis around the house. 
How many Pis is too many? 
@clivewriting 


£5 fora WiFi 
smart button? 
Yeah, we'll 
have seven 


Buy different 
buttons so you 
can identify 
which is 

which later 


You'll need a 
low-power, 
always-on 
computer 
with wireless 
- that's the 
definition of 
a Pi Zero W 


AN AMAZON 
DASH BUTTON 


Rescue Amazon’s £5 smart button from the monotony 
of ordering loo roll, and use it to do anything you like. 


he Internet of Things has two flaws: the name, 

and the need to get your phone out of your 

pocket, unlock it, swipe to the appropriate app, 
and wait for the app to load before you can do perform 
a basic task, such as turning on a light. Buttons are 
handy for a reason: they’re exactly where they need to 
be, and you can just press them. So if we’re going to 
have smart things, we need smart buttons. 

Typically these cost £40, but Amazon’s Dash Button 
costs a fiver. With a little tinkering and subversion, it 
can power anything from smart bulbs to alerts on your 
family’s smartphones to logging your billable hours. 

Head over to Amazon to buy some Dash Buttons 
(you'll need to be a Prime subscriber) and you’ll be 
baffled by the options: you can emergency-order raw 
virgin coconut oil (only £16.62 for 1.2kg), 20-sheet 
binding machines, or Nerf Darts with a Dash Button. 


The catch with these Dash Buttons is that you can 
only order certain products from certain firms. This 
matters, as Amazon will discount the price of a Dash 
Button from the first purchase made with it. Make 
sure you buy a button that lets you order something 
you'd buy anyway; that way, your Button is free. 
Once the Dash Button arrives, use the Amazon 
app (Android and iOS only) to set it up and order 
that first item. There are decent instructions at 
amzn.to/2mNhAat. Once you’ve ordered your 
product, go back into the Dash Devices and disable 
it. Then — bear with us — enable the Button again, but 
this time don’t select a product. Instead, just quit the 
app (don’t quit the process, close the whole app). This 
will have copied your WiFi credentials to the button 
without re-establishing the link to Amazon. It is now 
an unshackled smart button ready to be repurposed. 
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Jessie games 

We used Jessie Lite on our Raspberry Pi Zero W, as 

it will be running as a headless server with no GUI 
required. Once in, follow the usual update procedure: 
sudo apt-get update && apt-get -y dist- 
upgrade. As your Dash Button has already accessed 
your router, its MAC address should be listed in your 
router’s logs or DHCP tables. The location differs 
according to manufacturer. The button will show up 
as ‘Internet Device’ or similar. 

Now we’re ready to code. The idea behind this hack 
is to use the Pi as an interpreter. It constantly monitors 
your network for the appearance of the Dash Button, 
then uses that appearance as a trigger for some other 
action. We’re going to use Python to intercept those 
button presses, but this requires an extra module: 


sudo apt-get install -y pip 
sudo pip install scapy 


Pip is a Python-specific installer, and Scapy is the 
module we’ll use to ‘sniff’ for the Dash Button’s MAC 
address (pkt [ARP] .hwsrc) appearing on the network. 
As the Dash Button only powers up when you press 
its button, its MAC address will only appear after 

a button press. 


Button whole 

Now that we can intercept a button press, let’s do 
something with it. We’ve got a LIFX smart light, so 
we need the LifxLAN Python module: pip install 
1lifxlan. Open the trigger script and add the LifxLAN 
module’s functions to the script with the line from 
lifxlan import *. 

Now we need to find the MAC and IP address of the 
smart bulb from our router, and to name the bulb in the 
Python script using the ‘Light’ object of the LifxLAN 
module: bedroom = Light("'xx:xXx:XxXX:XX:XX:XX', 
'192.168.1.xxx'). We need to find the current power 
level of the bulb in order to toggle it, which we do with 
the current_state = bedroom.get_power() variable 
and the bedroom.set_power() commands of our if, 
else statements. Annoyingly, the Dash Button sends 
two ARP packets every time it is pressed, so we need to 
ignore the second ARP packet by using the second_arp 
Boolean variable. 

Once done, save your script, make it executable 
(chmod +x lights.py) and add it as acronjob 
(crontab -e) to make sure it runs every time your Pi 
boots: @reboot sudo python /home/pi/lights. py. 

Now we’ve got a smart button that we can stick to any 
wall, table, desk or bookcase to turn on our smart lights. 
And if a LIFX bulb sounds steep at £60 each, it would 
cost a lot more to install a new ‘dumb’ light switch once 
you’ve factored in gouging cable runs in the wall, hiring 
plasterers to make good and repainting a whole room 
or hallway. People have made Dash Buttons work with 
Philips Hue and Samsung SmartThings devices, too. 
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>PYTHON 


HACK AN AMAZON DASH BUTTON 


trigger py 


from scapy.all import * 


DOWNLOAD: 
magpi.cc/ 
DashButtonCode 


def arp _detect(pkt): 
if pkt[ARP].op == 1: #network request 
if pkt[ARP].hwsrc == 'XxX!:XxX:XX!XX!XX!XX' 
return "Button detected!" 


print sniff(prn=arp_ display, filter="arp", 
EXAMPLE CODE 


lights.py 


from scapy.all import * 
from lifxlan import * 


store=0) 


#Buttons 

andrex = 'XX:XX!XX!XX!XX!XxX' 

#Lights 

bedroom = Light( xx: xx =xXxK!XK:XxX:xx , 192.1638.1.xxx ) 


second arp = False 


def arp _detect(pkt): 
if pkt[ARP].op == 1: #network request 
if pkt[ARP].hwsrc == andrex: 
current_state = bedroom.get power() 


if current_state == 0: 
bedroom.set_power("on" 
else: 


bedroom.set_power("off") 


if second arp == False: 
sniff(prn=arp detect, filter="arp", store=0) 
second_arp = True 

else: 
second_arp = False 


Shoot for the (Button) Moon 


So, what else could you press your Dash Button to do? 
Hook your Python script into an online spreadsheet and 
you can log the time between button presses — useful 
for a musician logging practice sessions, or a freelance 
accountant logging billable hours. Tired of shouting 

up the stairs for your kids to come down for dinner? 
You could go the JavaScript route to connect an SMS 
messenger: press your Dash Button and they’ ll receive 
a text message (magpi.cc/2mt3zmo). Or use a service 
like Pushover (pushover.net) to make a smart doorbell, 
sending alerts to your smartphone or watch. 

Aaron Bell has detailed how to make a hacked Dash 
Button into an IFTTT trigger (magpi.cc/2msVvC5). 
We’d also thank Ted Benson for being one of the first 
Dash hackers (magpi.cc/2msUzhh), although updated 
Amazon firmware is incompatible with his code. 
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TONY HANSEN 


Tony is an ‘experienced’ software and 
computer engineer, meaning he's been 
doing this for quite some time. He 
rediscovered his love for the smell of 
solder a few years ago. 
magpi.cc/2nCOVrA 


ADDA 


TQ POWER DOWN 
YOUR 


Add a switch to your Raspberry Pi to safely shut it down without pulling the power 


o keep prices down, the Raspberry Piis missing Raspberry Pi’s GPIO pins. This article focuses on doing 


something that most electronic devices come something useful with those switches and LEDs. 
with: a switch to turn it on and off. That’s The safe off-switch is complementary to a reset 
OK, you say, we’ ll just pull the plug to turn it off. switch, which is the best method for starting the 
. Unfortunately, this can lead to corruption problems with Raspberry Pi up again. Issue 52 of The MagPi featured 
; (any salt the SD card. All the instructions say you should run the an excellent article on how to connect a reset button. 


7 ; , shutdown command before pulling the plug, but this is _ 
: scifion suitehee not always possible, particularly when your Raspberry Using GPIO Zero 


such as: Pi is running headless without a connected keyboard With the GPIO Zero library, the Python code to deal 
magpi.cc/ and monitor, and possibly even without a network with a button press becomes extremely simple. 
20CMKCm : : : : 
connection. So, what can a self-respecting DIYer do? Assuming your button is connected between GPIO 21 
The answer, of course, is ‘add your own switch’! and GND (ground), the code is nice and easy. 
Lots of articles are available to tell you how to You can download it from magpi.cc/2nD29F7 as 
use a breadboard to connect a button or LED toa shutdown-press-simple.py. 


This code creates a button on GPIO 21, waits for it 
to be pressed, then executes the system command to 
Momentary switch connected power down the Raspberry Pi. GPIO 21 is nice because 
to pins 39 and 40 it’s on pin 40 of the 40-pin header and sits right next to 
a ground connection on pin 39. This combination makes 
it difficult for an off-switch to be plugged in incorrectly. 
See cicica nat On a 26-pin header, GPIO 7 is similarly situated at the 
ready for a reset switch bottom, on pin 26, next to pin 25’s ground connection. 
Create the script on your Raspberry Pi using your 
favorite text editor (e.g., nano, Vim or Emacs), as in: 


$ nano ~pi/shutdown-press-simple.py 


Then add a line to the end of /etc/rc.local to run 
it at boot time: 
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Now, after rebooting, your script will be running 
and listening for a button (connected between GPIO 21 
on pin 40 and ground) to be pushed. 
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i A safe off-switch 
iB 


> Complementary reset switch 


>PYTHON 


DOWNLOAD: 
magpi.cc/2nD29F7 
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Preventing accidental button pushes 
One major drawback of the previous code is that any 
accidental push of the button will shut your Raspberry 
Pi down. It would be better if you needed to hold the 
button down for several seconds before everything 
powers down. Check out shutdown-with-hold.py. 

Instead of hard-coding the GPIO number 21 and 
the hold time, this code does a few things differently. 
First, it defines variables to hold these numbers at the 
top of the code. For a program this small, declaring 
the values at the top is not necessary, but it is good 
practice to declare any configurable variables near 
the top of the code. When making changes later, you 
won’t have to hunt through the code to find these 
variables. Secondly, it allows the GPIO number and 
hold time to be overridden on the command line, so 
that you can change them later without modifying 
the program. 

We then define a function named shutdown() to 
execute the poweroff system command. The button 
is also assigned to a variable for use in the next 
statement. This time, we are also specifying that the 
button must be held down, and when the hold time 
(6 seconds) has passed, any function assigned to the 
when_held event will be executed. We then assign 
that event to the shutdown() function we defined 
earlier. The call to pause() is needed to cause the 
script to wait for the button presses. 

If you look at the examples that come with the 
GPIO Zero source, you’|l find a script very similar to 
this one (magpi.cc/2IANxVA). 


Feedback while pressing the button 
We can do better. The major thing lacking with the 
above code is any sort of feedback. It is hard to tell 
that anything is really happening while you have the 
button pressed down. Fortunately, GPIO Zero allows 
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us to do much more with a button press, such as 
turning an LED on and off or setting it blinking, by 
attaching this to the button’s when_pressed event. 
We need to ensure that the LED is turned off if the 
button is not held down for the entire length of 
time. This can be accomplished by attaching to the 
when_released event. 

As before, the important work has been moved into 
functions named when_pressed(), when_released(), 
and the same shutdown() function we used before. 
These are assigned to their corresponding button events. 


Going further 
Can you think of other ways to provide feedback while 
pressing the hold button, or alternative ways to signal 
that it is time to turn off¢ How about using a buzzer, 
Or popping up a message on a screen? You could also 
use the on-board activity LEDs, making them blink 
faster and faster as it gets closer to shutdown time. 
Or even play an audio clip, such as “I’m melting”. The 
GitHub repository contains additional examples such 
as these. How about watching the ‘low battery’ signal 
from a battery pack as a signal to shut downe Let your 
imagination run wild. 

Now, which of your projects are you going to add 
shutdown and reset buttons to? 


Left Example of 
both an off and 
reset switch on 

a Raspberry Pi 
Zero. Right-angle 
headers are used 
for a compact 
connection. 

The switches 

are mounted 
directly onto an 
Adafruit case 
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Tutorial 


> Apple or Android 
mobile device 


> TouchOSC app 


> Raspberry Pi 3 


Create your own cut-out theatre controlled from your mobile device 


he idea for this project is to replicate a cut-out 
theatre using the Raspberry Pi to show your 
production. As the Pi’s screen will display 
the finished performance, that leaves no space on 
the screen for your controls. You might think that 
you could use a Keyboard, but that would not provide 
proportional control and would be difficult to drive. 
The alternative, of using external hardware, could 
get expensive. A cheap solution, if you already have 
a smartphone or tablet, is to use that to control the 
theatre. All you need is an interface you can customise, 
and a way to send and receive messages. Enter OSC. 
OSC stands for Open Sound Control, and is an open, 
extendable method of exchanging messages. While 
it was originally designed for sound applications like 
mixers and effects units, it’s flexible enough to be used 


for anything. TouchOSC is an excellent application that 
turns your mobile device into an OSC command-and- 
control station. It is hard to convey how satisfying it is 
to control the performance from a tablet! 


TouchOSC 


While it is not a free app, at less that £5/S6 it is not 
very expensive. There are two parts to it: the app 

that runs on your mobile device, and an editor for 
designing the custom control screens on your laptop. 
Go to the TouchOSC webpage at magpi.cc/2nSa69S 

to download the app and the editor. There are plenty 
of controls on offer, including faders, pads, rotary 
controls, and push buttons. Follow the instructions in 
‘Creating the custom performance’ to create a simple 
custom interface for this project. 


The wolf approaching Grandma 


Tablet controlling the performance 


Position of the Wolf 
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OSC messages 
Each OSC message consists of two parts: an address and 
a payload. The address part is identical to the path of a 
file on the Pi, the only difference being that there are 
no directories, and you can build your own hierarchical 
structure to suit your own needs. On TouchOSC, each 
window can have a number of tabs, each tab bringing 
up a different screen. The first default hierarchical 
level is the tab number, preceded by a forward slash. 
There is only one screen for this project so all messages 
Start with /1. The next level defines the control device, 
so a fader might have the address /1/fader1, or a push 
button /1/push4. That is as far down the hierarchy as 
we need to go for this project, but you can go further if 
you need to. The payload is the data that is delivered 

to that address, and can be in the form of an integer, a 
floating point number, text, or a Boolean logic value. 
When you send a message, you have to specify both the 
address and the payload. 

At the receiving end, the message address is 
normally parsed to see how to apply this number to 
the program you want to control. In our application, 
the payload will be used to move graphics around 
on the screen. You can send messages back to the 
TouchOSC controller, where they can be used to 
change the controls without user intervention, or to 
add feedback or acknowledgement of commands. 


Implementation 

We did hope to implement the OSC messages 

in Python, as there are a few libraries to do this. 
Unfortunately this proved impossible, because the 
ones we tried had poor documentation that was out 
of date, and either fell over when trying to cope with 
three faders, or required complex multithreading 
programming with no practical examples available 
online. Instead, we turned to Processing, which has 
a Simple and reliable interface for incoming OSC 
messages. We used Processing in the Ribbons project 


Tutorial 


DOWNLOAD: 
magpi.cc/1NqJjmV 


Check out Mike's 
Bakery videos at: 
magpi.cc/1NqJnTz 


Cemered 


Enabled 
Host 

Port (outgoing) 
Port (incoming) 


Local IP address 


in The MagPi #49, but in case you didn’t install it then, 
it can be installed from a command line by typing: 


curl https://processing.org/download/ 
install-arm.sh | sudo sh 


After reboot, it’ll then appear in the Raspbian menu 
under Programming. As with all network programs, 
you need to configure everything for your setup. 

In this case you only need two IP addresses. In the 
Processing code you need the IP address of the tablet, 
and on the tablet you need to set the IP address of the 
Raspberry Pi. This is shown in Fig 1. As in a network, 
the IP address can change from day to day, and it can 
be tedious always having to change the configuration 
before anything will work. You can get round this by 
accessing your router and telling it to always give a 
fixed IP address to both your Pi and your tablet. 
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192.168.1.71 
7000 


7001 


The theatre 


The theatre is simply a collection of graphics for the 
backdrops, props, and actors. These ware taken mainly 
from the story of Little Red Riding Hood in the Boston 
Sunday Globe of 1895. Curiously, this did not include an 
axe-carrying woodsman for the final scene, so we had 
to take one from another story and eliminate his wife by 
judicious use of the clone tool in our photo processing 
package! Fig 2 shows the results of this process. 

There are two actors in this story, and each one has 
its own slider control. Each actor also has a number of 
different costumes, with Riding Hood, in an amazing 
show of virtuosity, also playing the part of the 
woodsman, and Grandma’s head. This saves on sliders 
and makes the control panel cleaner. There are two 
‘heads’ for Grandma: one for talking to the Wolf, and 
the other for when the Wolf is pretending to be her. 
The movement controlled by the sliders is restricted 
to a simple nod, which is operated by tapping on 
opposite ends of the slider. 

The elements are stacked up in a fixed order from 
back to front, defining what will show in front of 
what. A more complex setup could control this order, 
at least for the actors and props, but we’re keeping 
things simple. The main task in adapting the graphics 
is to isolate the elements against a transparent 
background. You need to use a PNG type file and not 
a JPEG to define the transparent part. The image 
files must be placed inside the data subfolder of your 
Processing sketch’s folder, in the sketchbook folder. 


The software 

The structure of the Cutout_Theater.pde sketch is 
quite simple. The Draw function runs repeatedly, and 
if a change has been signalled by the DisplayUpdate 
variable, it draws the new window. This prevents a lot 


i ae » ie it «lien 
Removing the wife with the clone tool. It doesn’t work in real life paltagene iia soeatbeaaipel 
ss) 

of unnecessary drawings when nothing has changed. — /1/push8 a 
The Setup function defines the ports used for the OSC a LJ [] 

messages and loads in all the individual images. By /1/pushl —/1/push2 /1/push3 /1/push9 a 

far the longest function is oscEvent, which handles /1/faderl 
the incoming messages. This looks in turn at the two /1/push10 Gg Range 0 to -580 
active control elements, push buttons and faders. The si aa ea cd 

push buttons work as toggle buttons for the props 3 iz = Busi ts 

and background by sending back a confirmation of 

the push, and fixing the colour of the button. This — = eieeine - 

/1/fader3 Range —240 to 900 


shows you that a message has got through, because 
occasionally OSC messages, like all slip-formatted 
messages, can go astray. The actors’ costume buttons 
are implemented as radio buttons, so you can’t have 
more then one selected at a time. The controls for the 
faders simply pass on their value to the appropriate | 
variable. This is all that is needed because the range of 
the fader has been defined in the TouchOSC setup. | 
When the program first starts, the curtain is closed. 
A message is sent to the tablet to move the faders to 
reflect this. The initial elements for the first scene are | | 
also set up. There are a few other small functions that 


help with the parsing. 


Taking it further 
You can set up another play with your own characters, 
and once you see how it works, change the controller 
to cope with more variables. However, be careful not 
to make the control too cluttered. You could use some 
controls to trigger sound effects or animations, like 
the curtain automatically rising, or a prop falling over. 
You can replace the slider controls for the actors witha 
small XY pad for flying objects, or to put a bit of bounce 
into a walk. You could replace the single graphic of 
an actor with a sequence to show things like walking. 
Finally, you can add special effects, like lightning 
or acharacter dissolving in a teleporter. 


Normal 


Tutorial 


MULTIPROCESSING 
WITH PY THON 


Power up your Pi from Python by running loops in parallel 
using the multiprocessing module (fractals are included) 
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Right An image 
of the entire 
Mandelbrot set, 
as produced 

by the program 
mandelbrot.py 
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odern computers are good at multitasking. 
Quad-core devices like the Pi 2 and 3 can share 
work between their cores, and your programs 
can run up to four times faster if you know how to code 
them in parallel. However, this is not always easy. 
Programming languages like Python are sequential, 
executing instructions one at a time. What if you 

want to use all four cores? Luckily, there is help from 
the multiprocessing module, which allows parts of 
your program to run in parallel. To demonstrate how 

it works, we will adapt a program so that its central 
part runs in parallel, creating some beautiful fractal 
images in the process. First, you may need to install 
the matplotlib module, using: 


sudo apt-get update 
sudo apt-get install python-matplotlib 


0 


200 


0 200 


800 


1000 


Embarrassingly parallel fractals 

The program mandelbrot. py plots an image of the 
Mandelbrot set, which has an infinitely complex shape 
based on a Surprisingly simple mathematical rule. At 
its core, it performs a simple but potentially expensive 
calculation for every pixel. These calculations are all 
independent, so they can be run in any order or in 
parallel (this is called an ‘embarrassingly parallel’ 
problem). Take a look at the program. The work is done 
by a pair of nested for loops (labelled ‘main loops’ ) 
which call the function mandelbrot(), defined a few 
lines earlier, for each pixel in the image. This is the 
time-consuming part. As with all basic loops in Python, 
the calculations are performed sequentially, or one at 

a time. Try running the program from the command 
line (unfortunately, multi-process programs cannot be 
launched from IDLE): 


python mandelbrot.py 


It should generate a Mandelbrot set image like the 
one on the left. You can resize it and use the controls 
on the bottom left of the window to zoom and examine 
it in detail. This program uses only one processing 
core and runs in about 40 seconds on a Pi 3. We would 
like to run the main loops in parallel. This is relatively 
simple, thanks to multiprocessing. 


Introducing multiprocessing 
Before we can parallelise the loops, we need to make 
a small change. Replace the main loops with: 


Z 


[complex(x,y) for y in Y for x in X] 
map(mandelbrot, Z) 
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Now run the program again. It should take a similar 
amount of time to run. What has changed? Instead of 
calling the mandelbrot() function many times within 
the nested loops, we now build up a list of arguments 
for these calls in advance (Z) and use the built-in 
map() command to call the function on each entry in 
the list, placing the results in a new list (N). This does 
exactly the same thing as before, but our code is now 
in a form that we can parallelise more easily. Add the 
following line at the top of the program: 


from multiprocessing import Pool 


and change the main loop section to: 


p = Pool() 
Z = [complex(x,y) for y in Y for x in X] 
N = p.map(mandelbrot, Z) 


This is where multiprocessing works its magic. It 
creates a multi-process pool (p) and uses it to calla 
special version of the map() command. It makes all the 
same calls to mandelbrot() as before, but this time 
the work is split up and distributed in parallel using 
the pool. The number of processes in the pool matches 
the number of cores you have available (four in the 

Pi 2 and 3) by default. The results are collected back 
together into a single list (N) at the end. This program 
should run about twice as fast as before. If you run the 
top command in another Terminal window while the 
program is running, you will see the four extra Python 
processes that make up the pool. We have doubled the 
speed with a very simple change to our code. 


Bunch them up 

Can we do better? It turns out that the calls to 
mandelbrot() are too brief to run efficiently in 
parallel across the pool. For better performance we 
must bunch them together in groups. We can do this 
easily by returning to our two nested loops. For the 
inner loop, which produces the image along a single 
line in the x direction, define this function just below 
the definition of mandelbrot(): 


MANDELBROT SET IMAGES 


The Mandelbrot set is the set of complex 
numbers c for which the function f(z) = z*+c 
does not diverge for increasing z. In our plots, 
each pixel corresponds to a different complex 
number c. For every pixel, we determine 
whether the function diverges by iterating up 
to maxiter times. If we reach maxiter without 
diverging, then the point is deemed to be 
inside the set. Otherwise we record the number 
of completed iterations. Translating these 
numbers to a colour scale gives the patterns 
that we see surrounding the Mandelbrot set. 
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MULTIPROCESSING WITH PYTHON 


mandelbrot.py 


>PYTHON 

from numpy import linspace, reshape 

from matplotlib import pyplot DOWNLOAD: 
magpi.cc/2nD2PtR 

xmin, xmax = -2.0 ,0.5 # X range 

ymin, ymax = -1.25,1.25 # y range 

nx , ny = 1000,1000 =# resolution 

maxiter = 50 # max iterations 


def mandelbrot(z): # computation for one pixel 
Gee. 
for n in range(maxiter): 
if abs(z)>2: return n 
Z= z*z +c 
return maxiter 


# divergence test 


X 
Y = 


linspace(xmin, xmax,nx) # lists of x and y 
linspace(ymin, ymax,ny) # pixel co-ordinates 


# main loops 


Niet 
FOR yin Y= 
On xX aim xX: 
Z = complex(x,y) 


N += [mandelbrot(z) ] 


N = reshape(N, (nx,ny)) # change to rectangular array 
pyplot.imshow(N) # plot the image 
pyplot.show() 


def compute_all_ x(y): 
Z = [complex(x,y) for x in X] 
return map(mandelbrot,Z) 


This runs the inner loop sequentially, not in 
parallel. Now, for our main loop, we call this function 
in parallel, spreading the calls across the pool: 


Pool() 
p.map(compute_all x,Y) 


= sd 
| ee | 


This maps the work in larger chunks (whole inner 
loops rather than individual pixels). This program should 
now run roughly four times as fast as the original. 

With some simple changes and the use of 
multiprocessing, we have distributed our time- 
consuming loop over four cores instead of one. Our 
code is still simple and readable, although slightly more 
complex than before. For advanced programmers, there 
are much faster methods of plotting fractal images. 

The graphics processor on the Pi can outperform its 
CPU, as demonstrated by the Mandelbrot set program 
at magpi.cc/2mTVIKY. This program, written in C and 
OpenGL, is much faster than ours, but it is also far more 
complicated and nearly 20 times as long. 
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Tutorial 


.VS -> 


When 
accessing the 
elements of a 
structure, make 


sure you are 
using the right 
symbol. A . is 
used if your 
variable is an 


instance of the 
structure itself; 
a -> is used if 
your variable is 
a pointer to an 
instance of the 
structure. Using 
the wrong one 
will usually give 
an error from 
the compiler. 


NEW TYPES 
INSIDE 
STRUCTURES 


A structure can 
contain other 
new types 
(either plain 
types, enums 
or indeed other 
structures), 
Just make sure 
the typedefs 
for them occur 
before the 
typedef of 

the structure 

in which 

you want to 
include them. 


NUMBERED 


ENUMS 


When you 
create an 
enum, the 
compiler 
assigns a 
numeric value 
to each of the 
possible values. 
By default, 

it numbers 
the first in the 
list as O and 
counts up from 
there. You can 
override this 
by putting an 
equals sign 
after each 
named value 
and setting it 
to the value 
you want. 
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AN INTRODUCTION TO C 
MORE ABOUT TYPES 


AND VARIABLES 


Global variables, type definitions, enumerations, and structures 


n this instalment, we are going to look 
at some of the more advanced uses 
for variables and types, including the 
difference between local and global variables, 
defining new types, and the use of enumerations 
and data structures. 

In the examples in this series, we have always 
put variables inside function definitions. These are 
therefore local variables; that is, variables which are 


local to those functions and have no meaning outside 


the function. 


Global variables 
C also allows global variables; that is, variables which 
are defined outside all functions. These have global 


scope, which means that they can be read and written 


from any function within the program. Let’s look at 
an example: 


#include <stdio.h> 
int result; 


void add (int a, int b) 
{ 


result = a + b; 


void main (void) 
{ 

add (3, 4); 

printf ("The result is %d\n", result); 
} 


In this example, the variable result is a global. It 
can be read or written within both the add function 
and the main function. We write a value to it in add, 
and read it back in main, so we don’t need to return 
a value from add. 


This looks easier than passing values about all 
over the place, so why not just do this all the time? 
The answer is memory. Local variables in functions 
are temporarily allocated space while the function is 
running, and the memory is freed up as soon as the 
function ends. But global variables are allocated space 
when the program starts, and that space isn’t freed 
until the program ends — if you allocate enough of 
them, you can run out of memory on some systems. 


Type definitions 

In a previous instalment, we looked at the range of 
variable types in C: char, int, float, and soon. C 
also allows you to define your own types, with what 
is known as a typedef. Here’s an example: 


typedef unsigned char BYTE; 


This defines a new type called BYTE, which 
is another name for an unsigned char. (It is 
conventional to give user-defined types names in 
capital letters, to distinguish them from variables.) 

When we say this defines a new type, what it really 
does is create an alias to an existing type. This seems 
a bit pointless, but it can help in two ways. First, it can 
make it more obvious what your code is doing if you 
make the type names specific to your program’s data. 
Second, by defining specific types, you can get the 
compiler to warn you if you use the wrong type fora 
function argument or variable. 

There are a couple of cases where typedefs are 
particularly useful — these are enumerated types 
and data structures. 


Enumerated types 

Sometimes we want a variable which can only take 
one of a few possible values. C provides a type called 
enum for this purpose, which defines an integer with 
a fixed set of named values. Here’s an example: 
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#include <stdio.h> 


typedef enum { 
false, 
true 

} BOOLEAN; 


void main (void) 
{ 
BOOLEAN b_var; 


b var = false; 


if (b_var == true) 
{ 

printf ("TRUE\n"); 
} 
else 
{ 

printf ("FALSE\n"); 
} 


} 


The named values of the enumerated type are used 
instead of numbers. This can make code easier to 
understand, and is a good way of preventing errors, as an 
enumerated variable can only ever be set to a valid value. 


Structures 

The other useful thing you can do with typedef is 

to use it to define a data structure, a collection of 

individual variables which are grouped together. 
Here’s an example: 


#include <stdio.h> 


typedef struct { 
int inval1; 
int inval2; 
int outval; 

} MY_DATA; 


void add (MY_DATA *d) 
{ 


d->outval = d->invall1 + d->inval2; 


} 


void main (void) 


{ 
MY_DATA data; 


data.inval1 
data.inval2 
add (&data) ; 
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printf ("%“d + %“d = %d\n", data.invall, 
data.inval2, data.outval); 


} 
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“8 struct.c - /home/pt - Geany 


Tutorial 


[ei srute.- home: 


‘ket | File Edit Search View Document Project Build MMIC e § Gis [elle 
allows you to create your 
ivr ey icp 3 @ . own new data types 
<| Symbols |> | struct.c *_| 
= P Functions ‘|| 2 #include <stdio.h> 7 
2 
cp add [9] 3 typedef eee { 
4 int invall; 
@ main (24) ~ int inval2; 
& Structs ic , int outval; 
7 MY DATA; 
be anon_struct_0|/| g = 
% invall [4] | 2 ven add (MY_DATA *d) 
@ inval2 [5] ll d->outval = d->invall + d->inval2; 
“@ outval (6) ||| “S 
-| § lypedefs / Enums | | as void main (void) A data structure 
> | enables you to 
MY_DATA [7] ‘ : ‘ 
@ my . HY_DATA data; combine multiple 
18 data.invall = 5; pieces of data in 
19 data.inval2 = 7; the same type 
20 add (&data); 
21 
22 , printf ("The sum of %d and “d is “d\n", data.invall, data.ir 
23 
zi 
—————— 1. a ee 


ofS | 10:11:01: File fhome/piexamples.c opened(3). 
| Status 10:11:26: New file “untitled” opened. 


Compiler | 10:11:43: File /home/pi/examples.c closed. 


Vv | 10:11:43: File /home/pi/input.txt closed. _ 
line: 23/24 col:4 — sel:0 


10:11:41: File /nome/pi/struct.¢ saved. 


We use a typedef to create a data type called 
MY_DATA. The definition of the structure consists of 
the keyword struct with a list of variables enclosed 
by curly brackets. In this case the structure consists of 
three integer variables. 

In the main function, we declare an instance of the 
structure as a variable called data of type MY_DATA. 
We then access the individual elements of the 
structure by giving the name of the structure variable 
(data), a full stop (.), and the name of the specific 
element. So the line data.invali = 5 sets the value 
of the element inval1 of data to 5, and so on. 

The function add takes a pointer to aMY_DATA 
structure as its only argument. As ever, a function 
cannot change the values of its arguments, but can 
change values pointed to by its arguments, so we pass 
a pointer rather than the structure itself. 

To access the elements of a structure from a pointer 
to it, we replace the full stop with an arrow made up of 
a minus sign and a greater-than sign (->). So the add 
function reads the values of inval1 and inval12 in the 
structure pointed to by d, and then writes the result 
back to outval in the same structure. 

Structures are useful if you need to pass a lot 
of data around between functions. They are more 
memory efficient than having large numbers of global 
variables, as you only need to create the structure 
when it is needed rather than taking up memory all 
the time. 


INS TAB mode: Unix (LF) encoding: UTF-8 


filetype: C i Scop 


USE 
DIFFERENT 
NAMES 


While it is 
perfectly valid 
to give a local 
variable the 
same name 
as a global 
variable in the 
same program, 
don't do it! If 
you havea 
globalanda 
local with the 
same name, 
the local 
version is used 
in the function 
in which it 

is declared, 
and the 
global is used 
everywhere 
else - this 

can result in 
unexpected 
behaviour. 
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Tutorial 


STEP BY STEP 


LUKE CASTLE 


Luke likes coding and taking old Space 
Invaders games apart. He was in the 
top 50 for Astro Pi and created Pi 
fitness app PiMetre. 

magpi.cc /2iUTZXz 


SCRATCH GAME: 


Create a Scratch game that tests your skills at parking. 
Will you get your Scratch driving licence: 


> Car sprite 
magpi.cc/ 
2kiV2gc 


> Car park 
backdrop 
magpi.cc/ 
2kj3sEB 


> Coin sprite 
magpi.cc/ 
2kj3pbR 


n this tutorial, we’ll make a basic parking 

game using colour-based collision sensing 

with Scratch. Scratch is a child-friendly 
programming environment, developed by MIT. You can 
create games, music or even apps in this platform, and it 
is used in ICT lessons in schools. For this guide, you will 
follow some easy steps to create a simple but effective 
game. We will also be using angles, thanks to Miss 
Skelton, the author’s maths teacher. 


Design 

Download the assets from the list on the left and import 
the car park backdrop. Next, add the coin and car sprites. 
They’ ll be way too big to start with, so you will need to 
shrink each of them to the desired size by repeatedly 
clicking the ‘four inwards arrows’ icon above the stage. 
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Alternatively, you could create your own sprites 
and backdrop to make your game unique. Maybe you 
want to replace the blue river on the backdrop witha 
pink river, or replace the trees with footballs? If so, 
it is easy to edit or paint a new sprite costume using 
Scratch’s built-in editor, so be creative. 


start! 

Let’s make sure the car doesn’t start near the coin or 
on the grass - we all want a fair chance of earning our 
driving licence. Instead, it should appear at the start 
line on the left. With the car sprite and its Scripts tab 
selected, you will need to graba when green flag 
clicked Events block and drag it into the scripts 
area. Then attacha go to Motion block under it and 
replace the number in x with -229 and y to 24, so the 
car starts at the middle of the stage’s left edge. In 
addition, we need to ensure the car points to the right 
following any failed or successful attempt, so adda 
point in direction 9@ Motion block. 


On your marks... 

Let’s get the car on the road. Under the previous 
blocks, attach a wait 5 seconds Control block. 

This will give the player five seconds to get the mouse 
ready at the start of agame. Next, add a forever 
Control block. Inside the latter, place a point towards 
mouse-pointer Motion block, thena move 5 steps 


© This is the main objective of your game: 
get the coin and earn your driving licence, 
otherwise you'd better catch the bus 


° This is your car that you steer 
using the mouse pointer. Try 
to stay on the road! 
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Motion block. This bit of code means the car will 
forever head towards the mouse-pointer. You can 
change the number of steps in the move block to alter 
its speed if you like. 


>STEP-04 

Crash detection 

Next, we’ll create some code to check whether the 

car has hit the grass. Under the previous blocks, still 
within the forever block, addan if then Control 
block. In its small hexagonal field, add a touching 
color Sensing block. Click its blue square, then click 
on the green grass of your course on the stage to set 
the correct colour. In the gap of the if then block, 
placea say Game Over for 2 seconds Looks block, 
then attacha stop all Control block — this will stop 
all scripts running when the car crashes. 


>STEP-05 

Grab the coin 

We now need to create a second script for the car, to 
detect whether it is touching the coin in the parking 
space. Add another when green flag clicked block 
to the scripts area, then attacha forever block. Inside 
the latter, placean if then block. In its hexagonal 
field, adda touching Sensing block, and click its drop- 
down to change it to Sprite 2 (or the name of your coin 
sprite). Inthe gap of the if then block, placea say 
You Win for 1 seconds block, then attacha stop 
all block. This script makes sure that after the green 
flag is clicked, if the car is touching the coin, the car will 
say ‘You Win’ and the game will stop. 


>STEP-06 

Play it 

You have now created a very basic parking game. 
We’ve made it fairly simple, so you should be able 
to code it and play it within an hour. Have a go on 
the game and see whether you can earn your driving 
licence — or should you just stick with a bus pass° 
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PARKING MANIA 


Step-by-step How 76 


Follow Uheae tuloriats to get started with your: | 


Boh 


= 
*3 


i . < = Y 
i , 

SESZEZ ESET ESE 

= & a > . : 


when clicked 

go to x y: & 

point in direction €09 

wait @ secs 

forever 
point towards mouse-pointer 
| move © steps 


if touching color 7? 


say for © secs 
b 


stop all 


5 


when clicked 


touching thumbs-up-gold-coin-hi ? — then 


Stop other scripts in sprite 


r 
say for @ secs 
> 


Now it’s your turn. Here are some challenges for you 
to complete. Can you get the car to restart following a 
crash? How about creating a 5-4-3-2-1 countdown at 
the start of the game° Maybe you could add a timer? Can 
you create multiple levels? Why not add a coin variable? 
Instead of the car saying you have lost or won, why not 
make a special backdrop for the announcement? Why 
not, when you pass, create a driving licence? Otherwise, 
change the game in any way you want. 


Blacks | 


Tutorial 


Left You'll need 
to code this in 
Scratch 2.0, 

So open up your 
browser and go to 
scratch.mit.edu 


Left This is the only 
piece of code you 
will need to create 
your basic game 
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FREQUENTLY 
ASKED QUESTIONS 


YOUR QUESTIONS ANSWERED 


NEED A 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


Your technical hardware and software problems solved... 


RASPBERRY PI 


SPEEDS 


Right How 
quickly do all 
the pieces of a Pi 
communicate? 


Processor 

This is a bit different depending on the Raspberry Pi. 
The Model A, B, A+, and B+ are 700 MHz single-core 
processors. The Pi Zero and Pi Zero W have the same 
processor but it clocks at 1 GHz. The Raspberry Pi 2 
and 3 are both quad-core, with the Pi 2 at 900 MHz 
and the Pi 3 at 1.2 GHz. The Pi 3 processor is also 
64-bit, but it is used in 32-bit mode. 


USB 

The USB ports on all models are USB 2.0, which means 
they are limited to about 280 Mbit/s. On models with 
wired internet (Model B, B+, 2 and 3), the network 
cable is routed through the USB ports. 


Networking 

As the Ethernet is routed through the USB ports, you 
cannot make full use of Gigabit LAN on the Raspberry 
Pi. The networking is limited to 100 Mbit/s maximum 
speed. The wireless networking on the Pi 3 and Pi 
Zero W is 802.11n operating at 2.4 GHz, which means 
it operates at a maximum of 150 Mbit/s. 


Processor 

You can overclock the Raspberry Pi (increase the speed 
of the CPU), although with the Pi Zero, Pi Zero W and Pi 3 
you do so at your own risk. Other models support official 
overclocking modes in the config menu, increasing the 
CPU speed to up to 1 GHz. Any overclocking outside 
these menu options is at your own risk. 


USB 

You cannot increase the USB speed, but using fewer 
USB devices at any one time will help to improve 
performance. Make sure your USB devices are USB 2.0 
Hi-Speed, and that they are properly powered. 


Networking 

You can increase the speed of your wired network 
by using a USB Gigabit LAN adapter. While it won’t 
be a full Gigabit, it will be somewhat faster than the 
standard Ethernet connection on the Raspberry Pi. 


GPU 

The VideoCore IV for the Raspberry Pi is rated at 

250 MHz and can do 24 GFLOPS. The Raspberry Pi 3’s 
VideoCore has been overclocked slightly so it runs 
between 300 MHz and 400 MHz depending on whether 
it is working on 3D or video. 


CSI 

This is the connector for the Camera Module. It has 

a fairly high data rate of about 1 Gbit/s maximum per 
lane. There are a couple of available lanes in the CSI of 
the Raspberry Pi, so it has a maximum perfomance of 
about 2 Gbit/s, although the camera only uses one lane. 


DSI 

The DSI is used to connect a screen to the Raspberry 

Pi. It runs at about the same speed as the CSI. Both are 
connected directly to the GPU, so they can’t be used for 
generic data in the same way as a USB port. The DSI only 
uses one of its lanes when displaying data on a screen. 
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YOUR QUESTIONS ANSWERED 


FROM THE RASPBERRY PI FAQ 


RASPBERRYPI.ORG/HELP 


Why is there no real-time clock (RTC)? 


The expectation is that non-network-connected units 
will have their clocks updated manually at startup. 
Adding an RTC is surprisingly expensive once you have 
factored in batteries, area, and components, and would 
have pushed us above our target price. You can add one 
yourself using the GPIO pins if you'd like an interesting 
electronics project. 


Can | add extra memory? 


No. The RAM on the ModelA, A+, B, B+, Zero, and Zero W is 
a package-on-package (PoP) on top of the SoC, so it is not 
removable or swappable. The 1 GB of RAM on the Model 2 
and 3 is on a separate chip on the bottom of the PCB, but 
this is the maximum amount of RAM that the SoC in the 
more recent models can support. 


KEEP MULTIPLE 
PROJECTS IN 


ONE PLACE 


WD PIDRIVE FOUNDATION EDITION 
MADE FOR RASPBERRY PI 


Our custom NOOBS software enables you to install 


Project Spaces, so that you can create up to 5 projects 


that can all be managed from the WD PiDrive. 


CHOOSE THE 
VERSION THAT'S 


RIGHT FOR YOU: $18.99 


USB FLASH 64GB 


Includes MicroSD™ Card 


Why doesn't the Raspberry Pi include <insert name> 
piece of hardware or <insert name> sort of port? 


Our main aim is a charitable one: we are trying to build 
the cheapest possible computer that provides a certain 
basic level of functionality, and keeping the price low 
means we've had to make hard decisions about what 
hardware and interfaces to include. 


What is its operating temperature? 


The Raspberry Pi is built from commercial chips which are 
qualified to different temperature ranges. The LANg512 

is specified by the manufacturers as being qualified from 
0°C to 70°C, while the AP is qualified from -40°C to 85°C. 
You may well find that the board will work outside those 
temperatures, but we're not qualifying the entire board to 
these extremes. 


| 
> 
} 


USB HARD DRIVE 
250GB / 375GB 


Includes MicroSD™ Card with starter 


software and WD PiDrive Cable 
Starts at $28.99 


Learn more at wdlabs.io/mp57c 


© wDLABs 


Western Digital, WD, the WD logo, WDLabs, and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. Raspberry Pi is a trademark of the Raspberry Pi Foundation, microSD is a trademark of SD-3C, 
LLC. The term HDMI is a trademark or registered trademark of HDMI Licensing LLC in the United States and other countries. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies 
depending on operating environment. Product specifications subject to change without notice. Pictures shown may vary from actual product. © 2017 Western Digital Corporation or its affiliates. 


Everything you need to build awesome projects 


e’re into digital making here at The MagPi. the big impressive builds. If you have collected a few bits and & 
W, Incredible projects using Raspberry Pis cross bobs to build these small projects, you may have assembled 
our news and social feeds every day, and we the kit you need to attempt something bigger. 
love to discuss them and how we’d go about making Over the next few pages we’11 show you what you 
them. We tend to cover many programming and small need to make your own amazing, Raspberry Pi- powered 


projects in the magazine, so we don’t often get to do monster projects. 


PROTOTYPING 


Taking your first steps into building circuits for a project 


e 
° 
° 
° 
e 
° 
° 
° 
e 
° 
e 
e 
e 
° 
e 
e 
° 
° 
° 
e 
° 
° 
° 
e 
e 


e@e&eese8 &@&@eess8 e@evsst e@ess 8 @eeessd 


See ee ee ee eee eee eee eee eee 2 ee 6 2 


SO eeee ee eee ee eee eee ee eee eee e286 2 6 


S@Oeee ee eee ee eee eee ee eee ee ee 2 6 2 6 


Seee eee eee eee ee eee eee eee ee ee 2 @ 


raspberrypi.org/magpi 


S2Be@eeeee ee eee ee eee eee’ ee ee’ ee ce 8 @ & 


S@B@eeee eee eee es eee eo eee eee eee ee 2 2 6 


Seeeeeeeee eee e eee eee ee ee eee 6 2 6 


SBeeee eee eee ee ee eee eee ee ee ee 62 8 6 


S@e@eeee eee e ee eeee eee e ee ee ee ee 22 6 


eecrernereneeeneeenece2neoeceanececeoece eee eee ee 


&evs2 8 &evss8 & @edes 8 e&ess8 8 &eves 8 
&eess 8 @e2es 8 &eeveset &@eess & @eesesst 


he humble breadboard 

is an amazing device for 

prototyping circuits. We often 
use them in our tutorials, as they 
allow you to quickly wire up LEDs and 
other components to test concepts 
for your projects. Hopefully you 
already have one, but if not you can 
buy them from anywhere that sells 
electronics components, including 
Pimoroni, The Pi Hut, ModMyPi, etc. 

Breadboards allow you to connect 

up components without the need 
for soldering. You can reuse the 
components and quickly rearrange 
them to test your ideas. You can 
wire them up to each other and toa 
Raspberry Pi to create a circuit. Some 
of the holes are connected by built-in 
strips of metal, allowing you to use 
fewer wires to complete your circuit. 


A diagram showing how the holes in 
a breadboard are connected. Keep these 
connections in mind as you build 


A common input device; pushing 
down the button completes the 
circuit. Inputs can also include light 
sensors, temperature sensors, etc. 
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feature 


You can use these components in a 
breadboard. Most of them can be used 
in your final circuits as well. 


This wire uses a single core of 
metal throughout, which means 
that it bends easily. This makes it 
easy to use for prototyping circuits. 
While you can solder with this wire, 
it is not ideal for soldered circuits. 


These make it very easy to hook up 
a breadboard to the Pi. 


Most electronic circuits will require a 
resistor. Different circuits will require 
resistors of different strengths. 


The classic LED can be 
used to test your circuit, 
or to add lights to your 
project. Other outputs 
include buzzers, 
speakers, motors, 
actuators, and more. 
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BUILDING 


REAL CIRCUITS 


Turn your prototype circuit into a permanent circuit 


readboard circuits are 
great, and you could easily 
fit one into a project if you 
have space. Alternatively, use a 
soldering iron to make your circuit 
smaller and more permanent, and 
to protect against loose wires. 
Here’s what you’1l need to get 
started with soldering. 


HELPING HANDS 
When soldering tricky circuits, you 
can sometimes feel as if you need 


SOLDERING IRON several sets of hands. ‘Helping 

The most important piece of kit for hands’ can help! They usually 
soldering is the device that allows include a heavy base and two 

you to solder. It’s basically a very crocodile clips, so you can hold two 


hot pen tip that melts a metalalloy. things together steadily. They often 
After cooling, the solder keeps your include a magnifying glass to help 
wires and components in place, and __ with very delicate tasks. 

conducts electricity. 


DESOLDER PUMP 

SOLDER If you need to remove some solder 
This is the metal alloy that melts and from acircuit, heat it up with the 
cools to join components and wires soldering iron and then suck it up 
together. It usually contains tin and with this handy tool before it cools. 
lead, or tin and copper. Also known as a ‘solder sucker’. 
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MULTICORE WIRE 

This bendy, flexible wire is much 
better suited to soldering than the 
single-core wire used for prototyping. 


WIRE CUTTER/STRIPPER 


A special tool that not only helps you 
to cut a wire to the desired length, 

but also can strip the plastic coating 
away from the metal inside. 


CHOOSING A 


SOLDERING IRON 
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INTRODUCTION 


CO Sane neeeeeeee eee ee 
60 « 
wyseeo6 
; #ee cee 
Measure twice “a ae 


Make sure your wire is the 
correct length for your circuit. 
You can always strip one end 
and leave the rest attached to 
the spool to cut later. As the 
wire is very flexible, it is best 
to cut it a little longer than 
you need it to be. 


Tin the wire 

Once you’ve stripped the plastic, 
you should tin the wire. Hold 
one end ina ‘helping hand’ and 
apply some solder to the exposed 
wire so that it coats and covers 
it. This makes it easier to solder 
onto something else. 


Attach the wire 

Helping hands come in very 
handy here, holding both 

the wire and the component 
you want to solder. It is 

good practice to tin the leg 

of the component and the wire 
you want to solder to it, and 
then heat up the solder on both 
in order to fuse them together. 


Physical circuits can be finished off by tying up trailing wires 
and using wire wrap to cover exposed connections. Wire 
wrap shrinks as it is heated up (with a heat gun or hair dryer) 
and keeps your connections safe and secure. To protect a PCB 
solder joint, we recommend covering it in a little hot glue 
using the low temperature setting on a glue gun. 
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TOOLS FOR 


You’ll find different 

Screw measurements 

used online, depending 1-64 
on whether the guide 3-48 
you’re following uses 4-40 


imperial or metric 6-32 
scales. Here’sahandy 8-32 
table for converting 10-24 
screw diameters v-20 
between imperial (UNC %_-18 
or UNF) and metric. 34-16 
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1-72 
3-56 
4-48 
6-40 
8-36 
10-32 
1-28 
46-24, 
34-24 


M2 x 0.4 
M2.5 x 0.45 
M3 x 0.5 
M3.5 x 0.6 
M4 x 0.7 
M5 «x 0.8 
M6 x1 

M8 x 1.25 
M10 « 1.5 
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MAKERS’ TOOLKIT 


~ PRINTING 


A new way to make cases and parts, 3D printing can make makers’ dreams a reality 


SORTING OUT YOUR FILES 


Think of a 3D printer as being like 
a 2D printer: for 3D printing, you 
need to prepare the files you want 
to print. If you’re printing files 
that someone else has designed, 
the process should be very easy. 
Download and sort through the 
files recommended for your 
project, and make sure you are 
using the right ones. 3D-printable 
files will usually have file names 
ending in .stl or .vrml. 


The more simple the design, 
the easier it will be to print 


Making your own files 
involves diving into the world 
of 3D modelling software. You 
can choose from many paid 
professional programs, but there’s 
also the free and open source 
Blender 3D modelling software. 
There is a helpful guide to using 
Blender here: magpi.cc/20xxWFA. 
Remember, standard 3D printers 
print from the ground up in slices 
or layers. Keep this in mind when 
designing pieces to be assembled 
after printing. 


FINISHING YOUR PRINT 


Typically, 3D printed objects have 
a rough surface texture, due to the 
layering nature of the printing 
process. You can change the way 
you print to cut down on this 
effect, either by using different 
materials or by employing a 
different 3D printing technique. 

Mostly, you’ll find yourself 
sanding and filling and sanding 
and filling again to produce a 
smooth finish. Another solution 
is to add layers of PVA glue, which 
can be easily painted over. 

You can also try using acetone 
vapour baths to smooth out your 


surface finish. These take very 
little work, but they have their own 
disadvantages: you’ ll need to build 
your own DIY kit and deal with 
some nasty chemicals. 

Don’t forget to buy a small round 
file to widen screw holes if you 
need to! 


PRINTING YOUR FILES 


Once you have your files, you need to print them. 
You could get yourself a 3D printer (we’ve always 
liked the MakerBot series), which then allows you 
to print as much as you want (plastic permitting), 
making tweaks to allow for the perfect print. 

Printers are very expensive, not to mention noisy, 
so a popular alternative is to find a local 3D printer 
on 3DHubs.com, and send the files to them. They’11 
be able to give you recommendations on materials to 
print with, and they will usually mail the items back 
to you, or allow you to pick up the print yourself in 
some cases. There’s plenty of choice, and they are 
a lot cheaper than 
the setup cost for 
a 3D printer. 

Of course, if you 
plan to do a lot of 
3D printing, you 
might be better off 
paying the extra and 
investing in a 3D 
printer of your own. 


Printing on 3D Hubs can 
be a lot cheaper than 
you think 


lose SSS So SSeS ooo SSS SSS Se So SS Se SoS SS SSeS Se SSeS Se SSS Se So ese SoS SS SSeS Se SSeS SS SSS SSeS eso e esos ses esc esses sess soes 


o> Anamazing 
idea for a 3D print 
project we covered 
in issue 56. 


~ © © Before and 
after images of an 
acetone vapour- 
smoothed 3D print 
from PeterA8's 
great guide: 
magpi.cc/2oxLj8R 
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WOODWORKING 


Take your first steps into carpentry and make some truly wonderful projects 


fully stocked woodworking = 9). 


workshop can be vast, Need to make some holes? This is 
includes a lot more than what you need. Pick up a variety of 4% 
just a saw, and can get quite drill heads for wood and you'll be on 
expensive. Along with the tools your way. Be careful, though, as drills 
in your makers’ toolbox, here are can be dangerous. $ 
some of the basics you’ll need for 
projects involving woodworking. VICE 


Keeping your wood in place witha 
vice makes it easier to cut. We also 
really like the workbenches that 
grip your piece of wood, and even 
create a gap underneath so you can 


safely drill holes without damaging 
the bench. 


TAPE MEASURE AND PENCIL 


It seems obvious but it’s worth 


CLAMP 


Clamps are very useful for holding 


repeating. You don't want to go 
about measuring with the 15 cm sections of wood in place, to drill 
ruler from your old school pencil uniform holes or make precise cuts. 
You'll need several clamps for the 


best results. 


kit. Remember the golden rule: 


measure twice, cut once. 


POWER TOOLS 


Want to improve your carpentry skills? Then you may want to get some 
power tools. Of course, these should only be used with adult supervision. 
We recommend a power sander (sanding large bits of wood by hand is very 
boring) and a jigsaw. 

A jigsaw is a handheld tool with a saw blade jutting downwards. It is very 
useful for cutting complex shapes into, or out of, a piece of wood. To use it, 
you rest the metal plate on the wood and push the jigsaw along. This pushes 
the blade through the wood, usually following a pre-marked path. 


Fe Gener 
FIRST! “ 
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The 

Makespace in 
Cambridge is one of 
our favourite places 
in the world (and 

it's usually a bit 
quieter than this) 
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MAKERSPACES 


No space for a workshop? Find a local makerspace 


akerspaces (also known as 
M hackerspaces) are amazing 

places where people come 
together to build things. From 
software to circuits and 3D prints 
to metalwork, a good makerspace 
gives you access to loads of tools for 
building and making. Buying tools 
can be expensive and finding space 


can be difficult. Many makerspaces 
require only a small monthly 
membership fee to use all their 
equipment. They’re also usually 
filled with knowledgeable people 
who can help you with any tricky 
parts of your projects. 

To find a makerspace, check out 
hackspace.org.uk and look for 


locations near you. Alternatively, 
a bit of Google-fu should help you 
find somewhere in your area. 

Being a maker is also about 
being part of a wider community, 
and joining a makerspace can 
open the door to a community of 
makers, and a wealth of support, 
on your doorstep. 
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of coding 6 
creating 
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£12.99 


200 pages of 


ss THE ' Official Raspberry Pi 
RASPBERRY PI 


PROJECTS BOOK 


VOLUME 2 


Amazing hacking and making projects 
from the creators of MdgPi magazine 
Inside: 

How to get started with Raspberry Pi 
The most inspirational community projects 
Essential tutorials, guides, and ideas 


Expert reviews and buying advice 


Available 
ne magpi.cc/MagPiStore 


plus all good newsagents and: 


WHSmith BARNES&NOBLE 


9 Available on the GET IT ON rs | Available on 
@ AppStore JR P Google Play Amazon 
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Waker 
days 


Build 


YOUurF Very 


own internet-. 


connected 
radio with 
the Pirate 
Radio Kit! 


Pimoroni 


PIRATE RADIO 


PIRATE RADIO 


PI ZERO W PROJ 


This musical pirate booty is something to treasure 


elated he most expensive of 
R the four new Raspberry 


AMP ZERO 
PHAT 


JustBoom's 
Zero-sized 
board delivers 
up to 20W 
RMS of high- 
resolution 
audio to a pair 
of passive 
speakers using 
an optional 
external 
power supply. 


£24 / $37 
magpi.cc/2INJMKO 
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Pi Zero W project kits 
from Pimoroni, the Pirate Radio 
comprises a case full of quality 
components — everything you 
need to build your own internet 
radio. As with the other three 
kits, the packaging is top-notch 
and the hinged plastic case 
can be reused to store other 
components after the build. 

The key electronic items 
featured in the Pirate Radio kit are 
a Pi Zero W, with built-in wireless 
LAN and Bluetooth, and one of 


= 2° Pimoroni’s new pHAT BEATs. Also 
¥f rn 


available separately, the latter isa 


~ neat bit of kit that crams dual I2S 


DAC/amplifiers onto a Pi Zero- 
sized board, and can pump out 
3W per channel. 


The body of the radio is fairly 
easy to assemble — from acrylic 
pieces, legs, retainers, nuts and 
bolts — using the illustrated 
step-by-step online guide 
(magpi.cc/20117d7). As long as you 
follow the guide carefully to get 
the orientation right, everything 
slots together neatly. The acrylic 
pieces are all laser cut, including a 
neat speaker grille, so there are no 
nasty rough edges. 

The supplied 5W speaker simply 
slots onto four bolts holding the 
translucent front acrylic layer in 
place. Fortunately, the speaker 
comes with a length of dual wire 
already connected, so there’s 
no need to solder it. We’re not 
sure why the wire is much longer 
than required, though; while you 
could always cut it to size, we just 


ECT KIT 


wound it round the bolts at the rear 
of the radio. 

Unless you opt to buy a couple 
of Pimoroni’s ingenious hammer 
headers separately, you will need 
to break out the soldering iron 
to attach the supplied standard 
male and female headers to the Pi 
Zero W and pHAT BEAT. The latter 
then slots onto more bolts at the 
rear of the radio, with the Zero W 
mounted on top. The speaker 
wires are inserted into a couple of 
the terminal blocks on the pHAT 
BEAT, with the latter’s dip switch 
set to mono to combine its stereo 
channels. With that, your internet 
radio is built! 


Streaming software 
The Pi Zero W’s built-in wireless 
connectivity means there’s 
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no need to use a WiFi dongle 
plugged into a USB to micro- 
USB adapter, which makes for 

a more streamlined look to the 
radio. Even so, such an adapter is 
included in the kit, along with an 
HDMI adapter. This is presumably 
to enable you to hook the Zero 

W up to the monitor to install 
the software in Raspbian and set 
up WiFi, although we went the 


can be controlled via the pHAT 
BEAT’s five side-mounted buttons: 
forward/back to select stations, 
pause/play audio, and volume up/ 
down. The only slight downside 

is that the buttons are tiny, anda 
little difficult to locate on the side 
of the radio at times. The sound 
quality is good, however, with 

a decent amount of volume. Its 
real-time volume level is shown 


i 


Dm AT 


PIMORONI 
8 Raspberry PiZero fl] 
ProjectKit 


Pirate 
| Radio 


Left The kit 
comes packed 
in this neat 
reusable case 


pHAT BEAT 


Pimoroni's new Pi Zero-sized audio board packs 
twin MAX98357A DAC/amplifiers for stereo output. 
While the Pirate Radio uses mono mode, you could 
always add an extra speaker. Alternatively, you 

can buy the pHAT BEAT separately (£16.50/$21) 
and build your own custom stereo radio, or even 
repurpose an old ghetto blaster. The pHAT BEAT 
also features six push-buttons and two rows of 
super-bright APA102 RGB LEDs, for use as a VU 
meter or custom-controlled using the board's 
Python library (magpi.cc/20tOwp6). 


Quality components — 
everything you need to build 
your own internet radio 


instant headless route by adding 
ssh and wpa_supplicant.conf 
(with our router details) files to 
the microSD card before first boot. 
On the software side, Pimoroni 
has put together guides for three 
project examples. The first is for 
an internet radio based on the 
VLC daemon. As with the other 
examples, a single command is 
used to install all the required 
packages. You can then edit the 
playlist file to add URLs for your 
favourite radio stations. With 
this particular project, everything 
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dynamically by the pHAT BEAT’s 
super-bright LED VU meter. 

In addition, we followed 
Pimoroni’s tutorial to turn the 
Pirate Radio into an AirPlay speaker 
for streaming audio from an iPhone 
and iPad. Both this and the VLC 
radio work alongside each other 
happily, so you can switch from 
one use to the other. Highlighting 
the radio’s versatility, Pimoroni 
has also put together a Spotify 
streaming project using Modipy, 
controllable from a remote 
computer or device. 


While it's a slight shame that it doesn't make use 
of the pHAT BEAT's stereo capabilities, this is an 
excellent kit that is easy to assemble and results 
in a genuinely useful audio device with good 
sound quality. As well as internet radio and music 
streaming, potential uses include an Alexa-style 
voice assistant (with the addition of a USB mic), 

a speaker for musical HATs, and a speaking clock. 
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JUSTBOOM SMART REMOTE 


Maker 
says 
A 
powerful, 
Sleek and 
intelligent 
Smart device 
that is 
perfect for 
controlling 
your high- 
definition 


gudio setup 
JustBoom 


JUSTBOOM 
SMART REMOTE 


A minimalist AV remote with a six-axis gyro installed. 
Should this replace your current media remote? 


here were always jokes 
about the Wii Remote 
looking like a TV remote 
control, and it looks as if the 
JustBoom team has taken these 
jokes as inspiration for a slightly 
different kind of media remote. 


RII MINI 17 While looking simplistic, with only 
areata a few buttons, the Smart Remote’s 
the JustBoom secret is that it contains a Ssix-axis 
fen) Wale gyroscope that allows for a degree 
one has a few ; 

Ese na of motion control. 

to allow use as Luckily, this feature isn’t 

a wireless PC on all the time. It is activated 
mouse as well. 


and deactivated by pressing 
the button in the middle of 
the volume control strip, and 
emulates a mouse pointer moving 
around the screen as the user 
dictates, by flicking and tilting 
the remote. 

It works pretty well, making an 
instant transition between modes, 


£15 / $33 
magpi.cc/2mLP3qc 
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and can easily be recentred by 
turning the motion controls off 
and on again. We found on Kodi 
that it tracked across the screen 
fairly slowly, forcing you to bend 
your wrist to extreme angles to get 
to the corners. On Windows PCs, 
and indeed on the Raspberry Pi, it 
required less work to move around 
the screen. 

As for being a pure media 
remote, it does the job well. 
JustBoom claims that it’s designed 
to have the bare minimum of 
useful buttons for media viewing, 
and for Kodi this works well. 

The thing we missed most was a 
Play/Pause button, but you can 
definitely get used to tapping 
OK twice to pause, so it’s quite 
a minor complaint. 

The build quality is pretty 
decent as well, with the buttons 


making satisfying clicks as you 
push them. They’re also nice and 
large, so you’re unlikely to push 
the wrong one. 

As mentioned earlier, they do 
work on the Raspberry Pi desktop, 
which is pretty neat. The OK button 
works as a normal mouse click, 
and Back and Home work ona 
browser. It could well be useful in a 
classroom environment, as well as 
in the home, for media viewing. 


fast word 


It's a decent bit of kit 
with a unique feature. 
We'd like a Play/ Pause 


button, but otherwise it's 
perfectly serviceable. 
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PAPIRUS ZERO MEDIUM 


PAPIRUS 


ZERO MEDIUM 


An ePaper screen for the Raspberry Pi Zero 


PAPIRUS 
HAT 


The original 
full-size PaPiRus 
features a taller 
display, up to 
2.77 inches 

in size. The 
same ePaper 
technology is 
used to render 
text and images. 


£35 / $50 


magpi.cc/20uxPtz 
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any moons ago, we took a 
look at the original, full- 
size PaPiRus HAT. Now 
it’s the turn of its smaller sibling, 
designed specifically for use with 
the Pi Zero. Unlike conventional 
displays, it uses electronic paper 
(ePaper) technology to render text 
and images, which can remain 

on screen without any power 
connection for many days before 
slowly fading. Obviously, this is 
ideal for saving battery power ina 
portable project, such as a smart 
conference badge. The display is 
high contrast and readable even in 
bright sunlight. 

Like its big brother, the PaPiRus 
Zero is supplied in two main 
parts: the pHAT board with pre- 
soldered female header, and the 


- > screen itself, which is very thin. 


Assembly involves inserting the 
screen’s mini ribbon cable into 
the connector at the side of the 
pHAT, then securing the screen to 


the board with the double-sided 
Sticky pads supplied. We tested 
out the 2.0-inch Medium display 
with 200 x 96 pixels, but a Small 
1.44-inch screen (128 x 96) is also 
available, along with a multi- 
screen pack containing both sizes. 
With the unit assembled and 
mounted on a Pi Zero’s GPIO 
equipped with male header (not 
supplied), it’s time to install the 
software via a single Terminal 
command. A second command is 
required to set the correct screen 
size, then you’re ready to roll. 
One of the installed folders 
contains a few Python code 
examples to get you started, 
including a temperature readout 
that makes use of the pHAT’s built- 
in LM75 temperature sensor. The 
Buttons example demonstrates 
the use of the pHAT’s five GPIO- 
connected buttons. Located along 
the top edge, they’re tiny but could 
prove useful for switching the info 


Maker 
says 
Add low- 

power display 

technology to 
your Pi Zero 


projects! 
Pi Supply 


displayed. Other code examples 
include Conway’s game of life, 
which works well, and a digital 
clock. While some minor latency is 
noticeable as the numbers change 
on the latter, a ‘clear’ command can 
be used to wipe the display clean. 
The Papirus Python library 
includes a write function to 
print text strings, which can be 
positioned and sized, although it’s 
not clear how to change the font. 
A draw function displays a one-bit 
(black and white) bitmap image — 
The MagPi logo looked really cool! 
Handily, the software will convert 
most image types automatically. 


fast word 


While not suitable for 
applications requiring a fast 
screen refresh, the PaPiRus 
Zero is ideal for saving battery 
power in portable projects. The 


ePaper display is very easy to 
read in all but the lowest light 
conditions, from any viewing 
angle, and features a decent 
110 ppi pixel density. 
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GROUP 


LDETest 


Which program should you be using to code on the Raspberry Pi: 


he humble integrated development 


environment (IDE). Used the world over 
to play with code and make programs on 
computers of all kinds. You’re probably familiar with 


Scratch or IDLE, IDEs that serve a specific purpose, 


in this case coding in Scratch or Python respectively. A very popular cross-platform IDE, Geany has been around for 
Some IDEs let you program in several languages. Here quite a while and has received a reputation as a nice lightweight 
are some of the best on the Raspberry Pi. alternative to the bigger IDEs like Eclipse. It’s perfectly suited 


for the Raspberry Pi, aiding you in coding in all manner of 
programming languages, and it’s actually pre-installed on 


CODE “BLOCKS Raspbian PIXEL by default. 
mz As well as allowing for the all-important highlighting of code 


depending on the language, Geany also offers the ability to test 


A fairly traditional IDE, Code::Blocks is well code in a very similar way to the Run function in IDLE. Different 
known as an alternative for C coding, but it variables and functions can be jumped to from the left-hand 
can handle many different languages as well. column, allowing for quick browsing of the entire code. 

It’s not included in Raspbian PIXEL by default It’s a great piece of software that allows you to easily manage 
but it is in the package manager, so it’s just files and entire projects that use many types of code, and as it’s 
a case of installing it from the Terminal or in already on Raspbian, you can test your code on it as well. 


the software installer. 

Code::Blocks lets you organise your code and 
projects very easily, displaying the different 
functions and classes and whatever is important 
in the sidebar. It also contains a lot more 
debugging, testing, and building options than 
main rival Geany; however, we had some issues 
getting it to preview some Python code. 

It’s avery solid choice if you need a little more 
data and debugging in your projects, and again 
you can run compiled software straight on your 
Raspberry Pi for very efficient testing. 
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ADAFRUIT 


A quite different IDE, this one resides 
completely online. It’s not like Scratch 2, 
though, where you work on software online. 
This is a hybrid system that you install on the 
Raspberry Pi and then access via a web browser 
on a networked computer. 

The code and software on here is then stored 
in the cloud through Bitbucket, meaning you 
can access it from anywhere. Code can also be 
run directly to the Raspberry Pi via a Terminal 
So you can test it out as well. It allows you to 
use a whole host of different programming 
languages, and supports decent highlighting 
of them all. 

It doesn’t offer the same debugging and 
compiling suites of Geany or Code::Blocks, 
nor does it have a breakdown of functions and 
variables, instead favouring a project overview 
with your folders and files visible at all times. 
a aoe Still, it’s a great idea, especially when using a 


* ladies oe headless Raspberry Pi. 
KkKkkn 


Running locally on the Raspberry Pi, gedit is the GNOME text 
editor. While there is already a text editor in Raspbian, gedit 
supports code highlighting for a variety of programming 
languages, which the default text editor does not do. 

oa need to install it from the package manager, and it does RUNNER-UP 
add a fair few other packages to get it running. The good thing is 
that as well as being in the program menus, you can access it via 
the Terminal if you want to edit a file in there. Instead of using 


something like nano python. py you can use gedit python. py. 
It’s quite simple, though, offering just a pure view of the 


code with some highlighting and no project view, debugging, or DISTRACTION-FREE 
compiling options. It’s pretty good if you need just a simple IDE CODING AWARD 


that has few distractions. 
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RASPBERRY PI 
BESTSELLERS 


The new computing curriculum its a big 
step for many teachers. These useful 
guides will ease the transition. 


DEPLOYING RASPBERRY PI 
IN THE CLASSROOM 


Author: Guy Hart-Davis 
Publisher: Apress 
Price: £19.99 

ISBN: 978-1484223031 
magpi.cc/2ndLCo8s 


A manual of everything 

a teacher, classroom assistant 
or school IT admin needs to 
deploy and run a network 

of Raspberry Pis in the 
classroom. Liberate your 
school from Excel boredom! 


PYTHON IN EDUCATION 
TEACH, LEARN, PROGRAM 


Author: Nicholas Tollervey 
Publisher: O'Reilly 

Price: Free download 
ISBN: N/A 
magpi.cc/2ndCi3U 


Thoughtful introduction 

to Python's strngths and 
suitability for education, 

its readability, simplicity, 
cross-platform, and the 
secret weapon —- a wonderful 
community. Pass it on to 

a teacher you know. 


HELLO WORLD 


Authors: Various, contributing 
editor Miles Berry 
Publisher: Raspberry Pi 
Foundation 
Price: Free PDF download 
ISBN: N/A 
helloworld.cc 


~~ WE 


=e — =) 


Written “by educators, for 
educators,” a magazine from 
the Raspberry Pi Foundation 
that takes a cross-curricular 
look at tech, and educating 
young digital makers. A 
fascinating and diverse range 
of useful content. 


MagPi May 2017 


THE HARDWARE 


HACKER 


“A look inside a 


Author: Andrew Huang “tet 
Publisher: No Starch 
Price: £23.99 

ISBN: 978-1593277581 
magpi.cc/2ndLt44 


The Hardware 


HACKER 


a 


Part technology 

tour, part cultural re ns 
travelogue, wholly 

engaging — the first section of 

the book takes the reader into the 
electronics markets of Shenzhen, 
and the inside secrets of the 
factories where most makers who 
scale up to full manufacturing 
will end up looking for serious 
production runs. Memorable 
Statistics like “Foxconn workers 
consume 3,000 pigs a day,” rub 
shoulders with fascinating asides 
on everything from the use of 
chopsticks in assembling Tux USB 
sticks, to the hidden problems of 
eloss-finish plastics. 


UNIX: 


THE TEXTBOOK 


Authors: Syed Mansoor Sarwar, 
Robert M Koretsky 

Publisher: CRC 

Price: £89.00 

ISBN: 978-1482233582 

magpi.cc/2ndNhtU 


Raspbian is one of many 
GNU/Linux distributions 
that can run on the Pi, 
but GNU/Linux itself is one of 
more than 200 members of the 
UNIX family. An operating system 
fast approaching its half century, 
thanks to a number of sensible 
design decisions which, amongst 
other things, have permitted 
gradual evolution, while retaining 
a set of commands which would 
work on a release of any vintage. 
Changes can be most clearly 
seen when a classic old manual 
like this is updated after more than 


As if that were not enough, a short 
section on ‘intellectual property’ - a 
weasel term that Huang dismisses 

rapidly, before looking at shanzai 

innovations rarely seen here — 
leads on to Huang’s investigations 
into fake SD cards. Part 3 starts with 
a brief, personal history of open 
hardware leading on to three open 
hardware platforms built by the 
author: chumby, the Novena laptop, 
and chibitronics. Each a fascinating 
technical and manufacturing story. 

Rounding off this absorbing 
personal guide to the world 
of hardware is a ‘hacker’s 
perspective’ section, with insights 
into reverse engineering, then 
bioinformatics — and some 
surprising comparisons between 
H1iN1 and a computer virus. Lastly, 
extracts from interviews giving 
further insights into a remarkable 
career. Essential reading. 


Score 


a decade. Sarwar and Koretsky 
focus on Solaris and PC BSD, but 
the coverage here will be more than 
90% relevant to your Pi, or the VPS 
that hosts your website. The telltale 
changes include a new, 
nearly 100-page chapter 
on Python, and coverage 
of Git and virtualisation. 
You’ll need a lot of 
shelf space for this 1300- 
page hardback, but it?1] 
pay you back its price 
over many years if you’re 
looking for a text book 
which combines introductory 
tutorials on everything from shell 
scripts and systems programming, 
to file encryption and remote 
logins. While not the only good, 
comprehensive ‘Linux reference’, 
its wider remit, and many exercises 
for the reader, make it one of the 
more educational. 


Score 
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PERL 6 


AT A GLANCE 


Author: Andrew Shitov 
Publisher: Deep Text 
Price: £26.00 

ISBN: 978-9082156836 
magpi.cc/2ndJnkS 


rad 


As the dust settles 
on the long-awaited 
Perl 6, 2017 should 
see the publication 
of several — no doubt weighty - 
tomes on the language. First off 
the mark, with a nicely concise 
introduction (150 pages), Andrew 
Shitov’s guide is based on a series 
of introductory articles originally 
written in Russian. 

Perl 6 is not an incremental 
set of improvements over 
Perl 5. It’s a different language, 
beautifully declarative, with useful 
improvements including: good 
concurrency support; a better, 
Smalltalk-influenced object model; 


THE PHOTOGRAPHER'S 
GUIDE TO DRONES 


Author: Colin Smith 
Publisher: Rocky Nook 
Price: £26.99 

ISBN: 978-1681981147 
magpi.cc/2ndyFeh 


PHN TArn, oy 
UM INONAPHE 


Lots of makers 
have bought 
or built drones — they’re 
cool and have plenty of potential 
applications — but most people 
aren’t planning to set up delivery 
businesses with them. Photography 
from places you can’t otherwise get 
to is a great example of technology 
assisting and enabling new creative 
endeavours. Indeed, the first 
few sumptuous pictures in Colin 
Smith’s book are of coastal scenery 
and cities taken from several 
hundred yards out at sea, as are 
many of the spreads which open 
each chapter. 

Despite this and the landscape 
format of the publication, it is 
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Perk6 


at a Glance 


IER'S GuipE — — 


lazy evaluation; Lisp-like macros; 
and gradual typing — giving you 
the ability, effectively, to ‘turn on’ 
Static typing when needed. Floating 
point numbers can be stored 
as ratios for accuracy, and 
the ‘approximately equal 
to’ operator deals with 
minor imprecisions with e.g. 
complex numbers. 
Perl 6 At a Glance lives up 
to its title, giving excellent 
language coverage with 
no padding or fluff. Short 
paragraphs and code snippets 
take you through everything from 
building a web server, to creating 
new operators. Promises, and Perl 
6’s Channel class, fit the language 
for the concurrent world, and 
Grammars build on Perl 5’s powerful 
way with regular expressions. This 
book will open your eyes to Perl 6’s 
capabilities and uses: it is as concise 
and expressive as the language. 


Score 


more than a coffee table book. It 
is also a practical guide for any 
photographer wanting to take to 
the air without actually 
flying themselves. 
After suitable safety 
warnings — “spinning 
propellers and falling 
objects have the ability to 
injure people,” and most 
countries have regulations 
that you need to be aware 
of (this book is written from a US 
point of view) — it’s time to look at 
the gear, from the best available 
drones, to camera accessories. 
Smith has plenty of sound advice 
on flying a drone, and using it for 
photography and shooting video. 
Workflow, post-production, 
advanced techniques (panoramic 
images, special effects), and editing 
video round off an interesting and 
helpful guide. 


Score 


ESSENTIAL READING: 
MUSIC & AUDIO 


We love Sonic Pi (read our Essentials guide), 
but look what you can also do musically... 


Mastering MuseScore 


Author: Marc Sabatella ae 
Publisher: MuseScore 
Price: £25.99 

ISBN: 978-1508621683 
magpi.cc/2ndHZid 


Make and play back beautiful scores, 

and join a community of users sharing — —_ 
their music. Superb tutorial and 

comprehensive reference. 


Making Music with Computers 


Authors: Bill Manaris, Andrew R Brown 
Publisher: CRC Press 

Price: £33.99 

ISBN: 978-1439867914 
magpi.cc/2ndCBvf 


a, 


Making Music 


with Computers m 
U 


Well-written, beginner-friendly guide 
to creating music programmatically - 
with algorithms and data —- in Python 
(via Jython). 
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Linux Sound Programming 


Author: Jan Newmarch 
Publisher: Apress 
Price: £27.99 

ISBN: 978-1484224953 
magpi.cc/2ndOOAr 


The missing manual on programming 
all things audio on Linux, from sound 
fonts to controlling latency. 


Music Data Analysis 


Authors: Claus Weihs, Dietmar Jannach, 
Igor Vatolkin, Gunter Rudolph 

Publisher: CRC 

Price: £44.99 

ISBN: 9781498719568 

magpi.cc/2ndoSF6 


MUSIC DATA 
ANALYSIS 


Nicely varied collection of academic 
essays, from instrument recognition 
through machine learning to 
automated composition. 


The TAB Guide to 
Vacuum Tube Audio 


Author: Jerry C Whitaker 

Publisher: McGraw-Hill Education TAB 
Price: £34.99 

ISBN: 978-0071753210 
magpi.cc/2ndAaZF 


Get the most from your DAC HAT with ts - 
a home-built valve (tube) amplifier. 

Fascinating and idiosyncratic reworking 

of classic circuits. 
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FEATURE 


THE MONTH IN 


Everything else that happened this month in the world of Raspberry Pi 


ME ONCE... 


or better or worse, every year on 1 April people 
and companies come together to lie to — sorry, 
fool — their audience in the great tradition of aE.) 1 

April Fools’ Day. The Raspberry Pi community is not 

one to pass up on such an opportunity and there were a VOLTLOG 

few jokes going around on the day, centred around the We're very, very impressed with the working PCB 

humble Blueberry Delta. mock-up of an imaginary Raspberry Pi 4 design 

that was made for this video. It looks very real and 
, _ | even lights up! A lot of work went into making this 
| a td g RETROPIE FORUM board just for a little joke. There's a follow-up video 


G gi The RetroPie forum brought back ae eee 

a bit of a classic joke, redirecting = & [J : 

| cadetatia tnieinahlirs | everyone trying to get to the Cl — [J [= [ [ LJ | 
eprom puke RetroPie forum for support toa 


LMGTFY (let me Google that for F T — [ L C CI Le 


| you) page, searching for ‘retropie r 
documentation’. L ys * 


KODI SHUTDOWN 


showing how he made it, which is fascinating. 


In a stealth move to upgrade 
the website and forums, Kodi 


pretended they’d been shutdown. ETA PRIME 


"Jo stnre maantmauwd ty» Unted Wane Bait Coutander te msn 1 Apparently a real threat they get We can't quite identify the board used in this 

eo RAIL LNT eee regularly (people don’t understand video, although we'd like to point out the boot-up 

a isl that Kodi doesn’t provide content), screen for Raspbian is now a bit different, which 
it fooled many people until the instantly gives it away. A great effort, though. 


Site reverted. 
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with another mum at her 
school when she heard 


about Code Club for the first time. 


“Tt sounded really interesting,” 
Amanda tells us. “Iam nota 
coder, but I had dabbled in the 
past. | remember typing code 
into my Spectrum when I was six 
or seven... but I had never been 
taught to code. Coding wasn’t a 
scary thing, it was just something 


FIRFIELD 


PRIMARY 
CODE CLUB 


manda Coffey was talking 


running club coach, Ian. Their 
Code Club has been running for 


nearly two years now and is always 


oversubscribed with students 
wanting to learn how to code. It’s 
also resulted in some more formal 
lessons outside the Code Club to 
try to catch the kids who hadn’t 
been able to get in. 

“T was Standing in the 
playground when a child who had 
recently gone up to secondary 


I wanted my children to grow up 
seeing coding as just another tool, 
not something scary 


I hadn’t learnt. I knew that most 
of my peers didn’t feel the same 
way: they were scared of coding. 
I wanted my children to grow up 
seeing coding as just another tool, 
not something scary.” 

After learning about Code Clubs 
from fellow mum Jasjit, Amanda 
decided to start one with her 


Amanda mostly teaches her 
students Scratch, but they do 
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dabble in Python and HTML 


school walked in to meet her 
family,” mentions Amanda. “She 
wasn’t a Code Clubber, but had 
been taught by us in the lessons 
we delivered. She saw me and 

ran over, so excited, and told me 
that in computing lessons at their 
new school they were coding in 
Scratch, that the teacher had told 


Like a lot of Code Clubs, the gender 
ratio defies the IT industry stats 


them what game to make but only 
given them a few blocks. She was 
quite smug when she said it was 
easy and that her game worked 
perfectly and was great. 

“T have seen first hand how even 
a small amount of coding knowledge 
can help in the workplace,” Amanda 
continues. “However, I also grew up 
with peers who thought it was worse 
than Latin, impossible to learn, too 
geeky, etc. This new generation 
will need coding to succeed, more 
than we ever have. If we can let 
them learn through playing whilst 
they are still young enough not to 
have the barriers society gives us 
in their heads, then they will get 
to secondary school and just see 
coding and computing as the tools 
they are.” 

If you want to start your own 
CodeClub, you can find out more 
details at codeclub.org. 
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THe Raspserry Pi Ropotics CHALLENGE COMPETITION 


t’s weird to think that since we last had a Pi 

Wars, the original Robot Wars TV show has seen 

a revival and is already onto its second season. 
While the robots in that show fight to the very end, the 
only combat the Pi Wars robots face involves popping 


The event was a huge success 
and included special guest 
host Dr Lucy Rogers 


balloons. Although that doesn’t mean the robots don’t 
break down during other challenges... 

The event was a huge success and included special 
euest host Dr Lucy Rogers who, since appearing in the 
magazine last year talking about robot dinosaurs, has 
gone on to become a judge on the revived Robot Wars. 
Here are some pictures from Pi Wars 2017. 


Me 
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The Micro Pi Noon course for very small robots, built by Brian Corteil 
who was responsible for the robot build in The MagPi #51 
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A robot in the shape of Ely Cathedral (see below) 
is one thing, but one made out of a Fisher Price toy 
phone is quite another (photo by Sway Grantham) 


One of this year's wackier designs, this robot version of Ely 
Cathedral was a favourite at the event (photo by Anne Carlill) 


raspberrypi.org/magpi 


Want to keep your Raspberry Pi 
as secure as possible Then lock 
it inside a lock box with a digital 
security code. At least with this 
one you can turn it on and off via 
a switch on the outside of the box. 
Does that perhaps ruin some of 
This is utterly stupendous. Gordon Hlavenka hacked the security measures? 

his actual car to control Mario Kart 64. If you watch 

the video, you can see him flash his lights as he 

jumps to drift around corners. He’s even able to use 

the real accelerator and brake pedals. Hopefully it 

get disconnected when he goes for an actual drive. 


A good arcade build is always 
lovely to look at, and this 
wooden creation is no different. 
We especially like the glowing 
Reme@rictext cmbpeddedmmiro tine 
top of the wood. This is designed 
to sit ona tabletop, but we’d love 
to see some more old-school 
full-size cabinet builds. 


Using an old iPhone 5 slide- 

out keyboard, this maker has 
managed to create a hybrid Pi 
Zero W case that has a screen 


We’ve had Pip-Boys from Fallout in the mag before, and a fully functioning keyboard 
but we really love the design considerations put into input. It’s one of the smallest 
building this Fallout terminal. It’s 3D printable, so you mobile PC applications we’ve 
can make your own if you want to. Just make sure to seen for the Raspberry Pi and it 
copy that retro green-and-black monitor style. looks cool as heck. 


This Raspberry Pi recognises five notes on an ocarina, 
so you can play the songs from the Legend of Zelda: 
Ocarina of Time to activate stuff around the house. It’s 
so accurate that it lights specific LEDs for the specific 
notes being played. It comes with appropriate sound 
effects and recognises the best sound, Song of Storms, 
to turn on a humidifier. 
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From speaking at events to 

creating videos and resources, Matt 
Timmons-Brown continues to build 
upon a wonderful reputation in the Pi 
community as The Raspberry Pi Guy 
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Boasting the most successful Raspberry Pi- 
related channel on YouTube, meet Matt, the 
electric skateboard-riding Raspberry Pi Guy 


first set up my YouTube 

channel because I noticed 

a massive lack of video 
tutorials for the Raspberry Pi,” 
explains Matthew Timmons- 
Brown, known to many as The 
Raspberry Pi Guy. At 17 years old, 
the Cambridge-based student has 
more than 60,000 subscribers to 
his channel, making his account 
the most successful Raspberry Pi- 
specific YouTube account to date. 

If you’ve attended a Raspberry Pi 

event, there’s a good chance you’ve 
already met Matt. And if not, you’ll 
have no doubt come across one or 
more of his tutorials and builds 
online. On more than one occasion, 
his work has featured on the 
Raspberry Pi blog, with his yearly 


Raspberry Pi roundup videos being a 
staple of the birthday celebrations. 
With his website, Matt aimed 
to collect together “the many 
strands of The Raspberry Pi Guy” 
into one, neat, cohesive resource, 
and it works. From newcomers to 
the credit card-sized computer 
to hardened Pi veterans, The 
Raspberry Pi Guy offers aid and 
inspiration for many. Looking for 
a review of the Raspberry Pi Zero? 
He’s filmed one. Looking for a 
step-by-step guide to building a 
Pi-powered Amazon Alexa? No 
problem, there’s one of those too. 
Last summer, Matt introduced 
the world to his Raspberry Pi- 
controlled electric skateboard, soon 
finding himself plastered over local 


Matt was invited to St James's Palace and the Houses of Parliament 
as part of the Raspberry Pi community celebrations in 2016 
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Matthew and Eben review footage from 
their appearance on local TV news 


press, as well as the BBC and tech 
sites like Adafruit and geek.com. 
And there’s no question as to why 
the build was so popular. With 
YouTubers such as Casey Neistat 
increasing the demand for electric 
skateboards on a near-daily basis, 
the call for a cheaper, home-brew 
version has quickly grown. Using 
a Raspberry Pi Zero, a Nintendo 
Wii Remote, and a little help 

from members of the Cambridge 
Makespace community, Matt built a 


™ 


if 
4 
Z Ps awe 
‘ ‘ Jay 
-# Pee : 
ee ea eh, ye 
Ty “ip ’ 
a % : age 
t ee ‘o 1) *¥ 
ee 3 * 
t 4a . 
Ss pile 
’ 
‘ 5 
a , 


science coursework, the build 
demonstrates Matt’s passion for 
Space and physics. Used as a means 
of surveying terrain, LIDAR uses 
laser light to measure distance, 
allowing users to create 3D-scanned, 
high-resolution maps of a specific 
area. It is a perfect technology for 
exploring unknown worlds. 

In a recent interview at Hills 
Road Sixth Form College, where 
he is studying mathematics, 
further mathematics, physics, and 


It youve attended a Raspberry 
P1 event, there's a good chance 
you ve already met Matt 


board capable of reaching 30km/h, 
with a battery range of 10km per 
charge. Alongside Neistat, Matt 
attributes the project inspiration to 
Australian student Tim Maier, 
whose build we previously covered 
in The MagPi. 

Despite the success and the fun 
of the electric skateboard (including 
convincing Raspberry Pi Trading 
CEO Eben Upton to have a go for 
local television news coverage), 
the project Matt is most proud of 
is his wireless LIDAR system for 
theoretical use on the Mars rovers. 
Built for his A Level computer 
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computer science, Matt revealed 
where his love of electronics 

and computer science started. 

“T originally became interested in 
computer science in 2012, when I 
read a tiny magazine article about 
a computer that I would be able to 
buy with pocket money. This was a 
pretty exciting thing for a 12-year- 
old! Your own computer... for less 
than £30°!” He went on to explain 
how it became his mission to learn 
all he could on the subject and how, 
months later, his YouTube channel 
came to life, cementing him firmly 
into the Raspberry Pi community. 
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You can help global seismology by adding your 
data to feeds from a growing number of users 


OSOP brings seismography to everyone with the incredible Raspberry Shake kit 


The 

Raspberry Shake 
is very small. It 
only needs 26 
GPIO pins, so it 
can work on any 
Pi model 


88 | MdgPi May 2017 


eismic activity monitoring 
is important. It helps give 
people early warnings about 
possible natural disasters, as well as 
plotting how the earth beneath our 
feet is moving. It helps scientists to 
make better predictions and better 
models of our planet. 
“Our company is called 
OSOP and it’s existed for about 
ten years. We’re dedicated to 
making high-density solutions 
for earthquake monitoring.” 
Branden Christensen is the 
CEO of OSOP and he recently 
came to fame in the maker and 


. 
. 
ethyl 


Raspberry Pi communities when 
his company ran a very successful 
Kickstarter campaign for 
a consumer-grade seismograph. 
“That’s what we’ve been doing 
for years,” Branden continues. 
“We had a product that cost an 
order of magnitude less money 
than anything else on the market 
and with that product we’ve helped 
countries through geophysical 
institutes. That solution, even 
though it was an order of 
magnitude cheaper than other 
things available on the market, was 
still $5,000 a unit.” 


Turning to crowdfunding 
Like Raspberry Pi, they were 
interested in lowering the 
price even further and decided 
a network of hobbyist scientists 
with seismographs could have 
fun while still collecting 
useful data. 

“We're always interested in 
creating as high-density a network 
as we can,” explains Branden. “The 
motivations behind this are that 
with earthquake locations we always 


want to try and use automated 
processing systems, and those 
systems work best if you have a high 
density of stations. To have a really 
high level of confidence that seismic 
activity is of a certain magnitude 
in acertain place, you need to have 
high density. Raspberry Shake was 
born out of that philosophy, but it 
was also born out of the idea that 
we wanted to create a hobbyist 
seismograph. When we went into 
the Kickstarter campaign, we went 
into it thinking we just wanted to 
create a seismograph that will be 
cool for us and our friends. It was 
something we’d wanted to do as 
kind of a side project and we didn’t 
know if there would be a market 
for it, so we thought why don’t we 
throw it on Kickstarter and we’ 1l 
have our answer. 

“We thought if we can make the 
Kickstarter campaign successful 
and sell 20 or 30 of these units 
then we’ll make it. We ended up 
hitting our funding level for 20 
units in 18 hours. And then we 
went up to $50,000, and finally we 
almost made it up to $100,000.” 
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The campaign raised $99,258 
from 597 backers, and more people 
began pre-ordering after the 
funding period passed. 


Upgrading the kit 

“When we hit $50,000, we knew we 
had stumbled upon a new market,” 
Branden tells us. “A market that 
hadn’t been exploited before for 
doing citizen science seismology. 
So at that point we completely 
redesigned the product. We took 


a more robust solution that was 
competitive in the market.” 

Branden admitted that the 
Raspberry Pi wasn’t the only small 
computer considered for what 
became the Raspberry Shake. 
However, to them it was the best 
choice for the project. 

“The Raspberry Pi was central 
to the success of our campaign... 
We were sitting around a table 
and we thought, you know what, 
we’ re pretty sure that there are 


Were always interested 1n 
creating as high-density a 
network as we can 


it from being this gee-whizz 
seismograph to being something 
for geophysical institutes as well. 
We changed those specifications. 
We were able to get better prices on 
components so we ended up with 


Monitoring is done in 
real-time so the accuracy 
is extremely good 


Raspberry Shakes 
have been shipped to 
about 60 countries 
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lots of geeks out there like us that 
have a bunch of Raspberry Pis just 
kicking around. 

“So we Said, let’s do this 
differently. Let’s create a product 
that will run on any Raspberry Pi, 


mh 
iat 
and let’s make it so that people The 
don’t have to buy the Pi from us - eros 
let’s make it like a kit.” Of all the for sucha 
different options you can buy, the AOE MSS 
most successful sales we’ve had to 
date are not the turnkey solutions 
that include the Pi and everything 
and you just plug them in; it’s the 
one that has everything but the Pi.” 

You can get yourself a Raspberry 
Shake, or find out more about 
it, from raspberryshake.net. 
Join the growing network of 
hobby seismologists! 


Each triangle represents 
a different station. 
Clicking on it brings up 
the seismograph history 


May 2017 MagPi 89 


Community |(3"2\i 


EVENT CALENDAR 


Find out what community-organised, Raspberry Pi- 


themed events are happening near you... 


ROANOKE 
RASPBERRY JAM 


Want a Raspberry Jam in your 
area? Want to start one? 
Email Ben Nuttall about it: 

ben@raspberrypi.org 


v RASPBERRY JAM 
4 BOGOTA 


lal Gallet el) ley e INURE REGULAR EVENTS 


SKIPTON RASPBERRY JAM 
When: Saturday 13 May 
Where: Craven College, 

Skipton, UK 
magpi.cc/2mYOsyW 
Interaction, lightning talks 
and project sharing with other 
Raspberry Pi enthusiasts. 


ROANOKE RASPBERRY 

JAM 

When: Saturday 20 May 

Where: CoLab Roanoke, 
Roanoke, VA, USA 

magpi.cc/2mMXQZrB 

Bring your favourite projects to 

Share with other DIY makers. 

Attend a soldering workshop. 
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LEAMINGTON RASPBERRY 

JAM 2.0 

When: Saturday 27 May 

Where: Leamington Spa Library, 
Royal Leamington Spa, UK 

magpi.cc/2mXSsOF 

Create sweet music with Minecraft 

and Sonic Pi on the Raspberry Pi. 


NORWICH RASPBERRY 
JAM 
When: Saturday 27 May 
Where: The Forum, 

Norwich, UK 
magpi.cc/20H1tQh 
A separate part of the Norwich 
Gaming Festival focusing on 
learning with the Raspberry Pi. 


STAFFORD RASPBERRY JAM 
When: Tuesday 9 May 
Where: Stafford Library, 

Stafford, UK 
mMmagpi.cc/2mvLiVJ 
A big meetup of Pi enthusiasts 
where they all share ideas, help 
each other, and have fun! 


CORNWALL TECH JAM 

When: Saturday 13 May 

Where: Cornwall College, Camborne, UK 
cornwalltechjam.uk 

For anyone interested in 

technology, of all ages and abilities. 
Ask questions and learn about 
programming: Scratch, Python, 
Minecraft, and much more. 
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LEAMINGTON 
RASPBERRY JAM 2.0 


SKIPTON 
lg JAM 


STAFFORD 
RASPBERRY JAM 


MINECRAFT 
LIBRARY JAM 


v 


NORWICH 
RASPBERRY JAM 


6 CORNWALL TECH JAM 


MINECRAFT LIBRARY JAM 
When: Saturday 13 May 
Where: Central Library, 

Coventry, UK 
mMagpi.cc/2mvCGhO 
Build the world of Minecraft in code, 
then code your way around it on 
a Raspberry Pi. 


RASPBERRY JAM BOGOTA 

When: Saturday 20 May 

Where: Biblioteca Publica Virgilio Barco, 
Bogota, Colombia 

magpi.cc/28Kavk3 

The premier Latin American Raspberry 

Jam returns for another session with 

a full day of events introducing people 

to the Raspberry Pi. 
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HEAT MAP 


CAN YOU HELP INCREASE 
THE AMOUNT OF JAMS 
IN THE AREAS THAT NEED MORE? 


Community 


JAMS 
EVERYWHERE! 


MORE WAYS TO LEARN 
HOW TO START A RASPBERRY JAM 


As you may have seen in the 
news, there’s a brand new 

kit and guidebook from the 
Raspberry Pi Foundation 
community team that gives top 
tips and advice on how to start 
your own Raspberry Jam. It also 
includes resources for making 
promotional material, along with 
some stickers to give out! You 
can find out more information 
about the kit here: rpf.io/jam 
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Party with Pi 


I’m a big Raspberry Pi fan and I made my 
Way over to Cambridge for the Raspberry 

Pi Birthday Weekend in March, and it was 
great! Unfortunately, I only got to go on the 
Saturday and missed the talk you did on the 
Sunday about writing for The MagPi! I have 
a few ideas that I’d love to write for the 
magazine. Is there a video online of the talk 
so I can learn how to send articles to you? 


Lisa Nguyen 


Shame you missed the talk, Lisa! We are 
possibly going to be posting our own version 
online (our excellent video guy filmed it). 
However, if you can’t wait until then, a 
Raspberry Pi fan uploaded video of every talk 
to YouTube and you can see Rob give his talk 
there: magpi.cc/2nn5tRj. 

We’ ll reiterate one of the key points about 
writing articles for The MagPi: just email 
Rob! You can get in touch with him directly 
at rob.zwetsloot@raspberrypi.org and he’1l 
take it from there. 
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Forever third 
Congratulations on the sale of 
so many Raspberry Pis! Beating 
the Commodore 64 seems like 
no mean feat. How come you’ll 
forever be third, though? Are 
the numbers of PCs and Macs 
really that insurmountable: 
Also what is the debate 
surrounding the numbers of 
the Commodore 64 sold? 
Jonny S 


Well, as explained in the article, 
there have been about 1.25 billion 
PCs sold, x86 IBM/Windows PCs to 
be exact, and 80 million Intel Macs 
as well. Sales of both aren’t slowing 
down, so it’s not like competing 


Sate 


(O38; 
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A retro favourite. Will the Raspberry 
Pi be remembered so fondly many years 
later? We hope so! 


with the C64 where a set number 
of machines was sold, and that 
number will never change. 

As for that C64 number, the 
controversy comes from various 
claims about how many have 
been sold. A book by an executive 
at Commodore claimed that a 
certain number sold consistently 
throughout its life, which adds 
up to a total of around 23 million. 
Reports by Commodore itself 
give a much lower number, 
and a count of all the serial 
numbers actually sold gets us 
to the 12.5 million number. 

This one is considered to be the 
most accurate. 
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The Big Birthday Weekend was amazing, and 
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we hope to see more of you there next year! 
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FROM I HE FORUM: The error about the graphical package manager not 
=™ being in Raspbian is our fault — we missed it when 


it went to print, but realised afterwards that it was 
wrong. As we hadn’t actually launched the issue 
yet, we decided to do a little update to the PDF. We 


The Raspberry Pi Forum is a hotbed of rarely do this with the magazine issues, and almost 
conversations and problem-solving for the never after it’s out, so we made the call to do it for 
community. Join in via raspberrypi.org/forums the digital one. 


As for the missing pages, they’re in the print 
*ve just been having a read through issue 56, mainlythe OS ___ versions we’ve seen! Give the pages a little rub in 


choice at the moment. Some OSs for me to have a look at, Case ineymeed to umeniek themselves: 
the camera one seems interesting. Anyway, glad you found an OS or two to check out 
Noticed one error, oddly for Raspbian. You say there is no from the guide! 


graphical manager installing, but there is. However, I’ve just 
checked online and it’s different. It also seems to have quite a few 
more OSs covered than my print version (unless I was sleeping?). 
It jumped from Raspbian to something like OSMC/RetroPie. Some 
three or four more pages: Is there a big error in the print version: 
bensimmo 
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WD PIDRIVE NODE ZERO 


Build your own mini DLNA + Samba file server, wireless 
mobile storage device, a Pi Music Box with local storage 
and so much more. 


Includes: 

¢ 314GB WD PiDrive, Raspberry Pi Zero, 
and custom adapter board 

¢ SD card with starter software 

e Mini HDMI adapter cable 


8 
ww gone’ BEN 


year ot BEES 


@ WD LABS Learn more at wdlabs.io/mp57b 


Western Digital, WD, the WD logo, WDLabs, and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. Raspberry Pi is a trademark of the Raspberry Pi Foundation. microSD is a trademark of SD-3C, 
LLC. The term HDMI is a trademark or registered trademark of HDMI Licensing LLC in the United States and other countries. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies 
depending on operating environment. Product specifications subject to change without notice. Pictures shown may vary from actual product. © 2017 Western Digital Corporation or its affiliates. 


OF WDLABS 


AND COMPUTER HARDWARE 


BE WON! 


$300+ 
MUST 


In association with 


© wpDLass 


WHAT WOULD 
W46)0) BUILD @©wp ass 
WITH THE ay 
WD PIDRIVE 
COMPUTE 
CENTRE KIT? 


To enter visit: —Do Rie 
wdlabs.io/mp57contest 0 GR se ae 


Enter by 26 May 2017 
for your chance to win! 


Learn more: 


Find out more about the WD PiDrive Compute Centre: magpi.cc/ComputeCentre 


Terms & Conditions 

Competition closes on 26 May 2017. Prize is offered in the UK and US to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize 
supplier, their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from 
the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 


spam. Participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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lono Pi 
A professional I/O expansion 
for your Raspberry Pi 


Board or pre-assembled DIN module with: 
- 4 relay outputs 250V - 6A 
* 2 analog inputs O-30V 
* 2 analog inputs O-3.3V on internal headers Me \ 
- 7 configurable digital |/O 
(Up to 3 open collector outputs 


with over-current protection) aa 
- 1-Wire and Wiegand support 060 
* 9-28Vdc power supply oo 
- Real time clock 
- CE/ROHS Certified a ae © 
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Column THE FINAL WoRD 


MATT RICHARDSON 


Matt Richardson is the executive director of Raspberry Pi 
Foundation North America and author of Getting Started 
with Raspberry Pi. Contact him on Twitter @MattRichardson. 


‘PRODUCT OR 
F PROJECT’? 


Major product makers are opening their arms to hobbyists. 


aking inspiration from a widely known 

Mahatma Gandhi quotation, | like to tell 

people, “make the thing you wish to see 
in the world.” In other words, you don’t have to 
wait for a company to create the exact product 
you want. Prototyping with hardware has become 
easier and more affordable, empowering people to 
make products that suit their needs perfectly. And 
the people making these things aren’t necessarily 
electrical engineers, computer Scientists, or 
product designers. They’re not even necessarily 
adults. They’re often self-taught hobbyists who are 
empowered by maker-friendly technology. 

It’s a subject I’ve been very interested in, and I 
have written about it in this column before. Here’s 
what I’ve noticed: the flow between maker project 
and consumer product moves in both directions. In 
other words, consumer products can start off as maker 
projects. Just take a look at the story behind many of 
the crowdfunded products on sites such as Kickstarter. 
Conversely, consumer products can evolve into maker 
products as well. The cover story for this issue of 
The MagPi is a perfect example of that. Google has given 
you the resources you need to build your own dedicated 
Google Assistant device. How cool is that? 

But consumer products becoming hackable hardware 
isn’t always an intentional move by the product’s 
maker. In the 2000s, TiVo set-top DVRs were a hot 
product and their most enthusiastic fans figured out 
how to hack the product to customise it to meet their 
needs without any kind of support from TiVo. 


Embracing change 

But since then, things have changed. For example, 
when Microsoft’s Kinect for the Xbox 360 was released 
in 2010, makers were immediately enticed by its 
capabilities. It not only acted as a camera, but it 


MagPi: May 2017 


Matt Richardson explores why 


could also sense depth, a feature that would be useful 
for identifying the position of objects ina space. At 
first, there was no hacker support from Microsoft, 

so Adafruit Industries announced a $3,000 bounty 

to create open-source drivers so that anyone could 
access the features of Kinect for their own projects. 
Since then, Microsoft has embraced the use of Kinect 
for these purposes. 

Consumer product companies even make versions 
of their products that are specifically meant for 
hacking, making, and learning. Belkin’s WeMo home 
automation product line includes the WeMo Maker, 

a device that can act as a remote relay or sensor and 
hook into your home automation system. And iRobot 
offers Create 2, a hackable version of its Roomba 
floor-cleaning robot. It’s aimed at STEM educators, 
but could be used for personal projects too. Electronic 
instrument maker Korg takes its maker-friendly 
approach to the next level by releasing the schematics 
for some of its analog synthesizer products. 

Why would a company want to do this? I think 
there are a few possible reasons. For one, it’s a way of 
encouraging consumers to create a community around 
a product. It could be a way for innovation with the 
product to continue, unchecked by the firm’s own 
limits on resources. For certain, it’s an awesome feel- 
eood way for a company to empower their own users. 
Whatever the reason these products exist, it’s the 
digital maker who comes out ahead. They have more 
affordable tools, materials, and resources to create 
their own customised products and possibly learna 
thing or two along the way. 

With maker-friendly, hackable products, being 
a creator and being a consumer aren’t mutually 
exclusive. In fact, you’re probably getting the best of 
both worlds: great products and great opportunities 
to make the thing you wish to see in the world. 
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Code Club is a nationwide network of volunteer-led after school clubs 
for children aged 9-11. 


We're always looking for people with coding skills to volunteer to run 
a Club at their local primary school, library or community centre for an 
hour a week. 


You can team up with colleagues, a teacher will be there to support 
you and we provide all the materials you'll need to help get children 
excited about digital making. 


There are loads of ways to get involved! 


So to find out more, join us at www.codeclub.org.uk 


[his advertising space was kindly donated to Code Club by MagPi Magazine 
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Build your own credit card 
sized computer 


Get started with program ming 
Set up a Media Center 
Make simple electronic circuits 
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Available in Europe 
through RS Components 
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